---
title: "Follow one or more entities"
method: POST
path: "/api/follows"
tags: ["Follows"]
---

# Follow one or more entities

`POST /api/follows`

## Request

- Base URL: `https://api.sponsorunited.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sponsorunited.com/api/follows`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sponsorunited/apis/sponsorunited-api/docs/api/follows/post.ts> (a function with typed inputs; its response is checked against the schema)

Upserts follow relationships for the authenticated user. Duplicate or already-followed entries are silently ignored. Validates that every ULID exists in its entity table; returns 422 with a list of unknown ULIDs otherwise.

## Request body

- object
  - `follows` object[], required
    - `entity_type` 'brand' | 'property' | 'agency', required
    - `entity_ulid` string, required: 26-character ULID of the entity

## Response `200`

Follows created (or silently de-duplicated).

## Other responses

- `401`: Unauthenticated.
- `422`: Validation error — unknown entity_type, malformed ULID, or ULID not found in the entity table.

---

[API](https://skmtc.dev/sponsorunited/apis/sponsorunited-api.md) - [All operations](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/revisions/cbf1ca5bff8f?raw)