Skip to main content
POST
Follow an X user

Authorizations

Authorization
string
header
required

API key in the format: Bearer {api_token}

Headers

Idempotency-Key
string

Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.

Maximum string length: 255

Body

application/json
target_user_id
string
required

Numeric X user id to follow.

account_id
string

Connected X account to act as (sacct_ prefix id). Optional: a platform connects once per account, so the X account is resolved automatically.

Response

Follow confirmation

target_user_id
string
following
boolean
pending_follow
boolean
platform
string