Skip to main content
POST
/
twitter
/
follow_twitter
Follow a user on X/Twitter
curl --request POST \
  --url https://api.aisa.one/apis/v1/twitter/follow_twitter \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "target_user_id": "2244994945"
}
'
{
  "data": {
    "following": true,
    "pending_follow": false
  }
}
Follow a user on X/Twitter on behalf of the authenticated source user. This is a direct proxy for the official X v2 POST /2/users/{id}/following endpoint, routed through the AIsa gateway at https://api.aisa.one/apis/v1/twitter/follow_twitter.

​
Prerequisites

  • An AIsa API key (Bearer token for every request).
  • A one-time OAuth authorization for the source user account. Link your X account by calling POST /apis/v1/twitter/auth_twitter — that endpoint kicks off the OAuth flow and stores the resulting session against your AIsa key, so you do not pass OAuth tokens in the request body here.
  • The X session must hold the following scopes: follows.write, tweet.read, users.read.
Looking to follow by @username instead of numeric ID? Resolve the user first with GET /twitter/user/info, then pass the returned id as target_user_id.

​
Response fields

FieldTypeMeaning
data.followingbooleantrue once the source user follows the target. For public accounts this is the success signal.
data.pending_followbooleantrue when the target is a protected account — the follow request has been sent and is awaiting the target user’s approval.
For the full set of error responses and retry guidance, see Error Codes. Write endpoints count toward your standard key RPM/TPM — see Rate Limits.

Authorizations

​
Authorization
string
header
required

Your AIsa API key. The authenticated source user (the account doing the follow) is determined by the OAuth session attached to your key.

Body

application/json
​
target_user_id
string
required

Numeric ID of the X/Twitter user to follow. Must match the X regex ^[0-9]{1,19}$.

Pattern: ^[0-9]{1,19}$
Example:

"6253282"

Response

Follow succeeded (or was already in place).

​
data
object