Sign in

v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
Twitter Engagement

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

Request body

accountIdstring required

The social account ID

targetUserIdstring required

The Twitter ID of the user to follow

Response

User followed or follow request sent

statusstring
targetUserIdstring
followingboolean
pending_followboolean

True if the target account is protected and a follow request was sent

platformstring

Example response

{
  "status": "success",
  "platform": "twitter"
}