Join Community API

Join an X/Twitter community on behalf of an account via API. $0.002 per call. GetXAPI join community endpoint documentation.

POST/twitter/community/join

This endpoint costs $0.002 per API call.

Joins an X community on behalf of the auth_token's account.

Request Body

Field	Type	Required	Description
`auth_token`	string	Yes	User's auth token
`community_id`	string	Yes	Numeric community ID (e.g. from the community URL `x.com/i/communities/<id>`)
`proxy`	string	No	Proxy URL (`http://`, `https://`, `socks5://`, or `socks4://`)

Notes

The server derives ct0 and twid automatically from auth_token.
Some communities require approval; in that case the account is left in a pending/requested state rather than immediately joined.

Response (200)

{
  "status": "success",
  "msg": "Joined community",
  "data": {
    "community_id": "1493446837214187523",
    "name": "Build in Public",
    "role": "Member",
    "joined": true
  }
}

Error Responses

400 - Missing community_id

{
  "error": "Missing required field: community_id"
}

401 - Invalid auth_token

{
  "error": "Invalid auth_token - could not extract userId"
}

Example

curl -X POST "https://api.getxapi.com/twitter/community/join" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "auth_token": "your_auth_token",
    "community_id": "1493446837214187523"
  }'

Join Community