Skip to content

Follow a user

Follow a user on X/Twitter. Requires the follows.write OAuth scope. For protected accounts, a follow request is sent instead (pending_follow will be true).

POST /v1/twitter/follow

Follow a user on X/Twitter. Requires the follows.write OAuth scope. For protected accounts, a follow request is sent instead (pending_follow will be true).

Request body

Content-Type: application/json

  • accountId (string) required — The social account ID
  • targetUserId (string) required — The Twitter ID of the user to follow

Responses

200 — User followed or follow request sent

  • status (string)
  • targetUserId (string)
  • following (boolean)
  • pending_follow (boolean) — True if the target account is protected and a follow request was sent
  • platform (string)

400 — Bad request or platform limitation

401

404 — Account not found