Appearance
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 IDtargetUserId(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 sentplatform(string)
400 — Bad request or platform limitation
401
404 — Account not found