Engagement actions

Follow, unfollow, like, retweet, and post tweets from a connected account. Like DMs, all actions require an Idempotency-Key header.

Follow a user

POST/v1/actions/follow5 credits

curl -X POST https://api.xautodm.com/v1/actions/follow \
  -H "Authorization: Bearer $XAUTODM_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"account_id":"acc_1a2b3c","user_id":"44196397"}'

Field	Type	Required	Description
`account_id`	string	Required	The connected account performing the action.
`user_id`	string	Required	The user to follow.

Unfollow is identical at POST /v1/actions/unfollow.

Like & retweet

POST/v1/actions/like5 credits

curl -X POST https://api.xautodm.com/v1/actions/like \
  -H "Authorization: Bearer $XAUTODM_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"account_id":"acc_1a2b3c","tweet_id":"1750000000000000000"}'

Retweet is identical at POST /v1/actions/retweet.

Post a tweet or reply

POST/v1/tweets5 credits

Omit reply_to_tweet_id for a standalone tweet; include it to reply.

curl -X POST https://api.xautodm.com/v1/tweets \
  -H "Authorization: Bearer $XAUTODM_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"account_id":"acc_1a2b3c","text":"gm","reply_to_tweet_id":"1750..."}'

Each action counts against X's own rate limits and spam heuristics. Keep volumes human and add jitter between actions to protect the account.

Idempotency & retries →Errors & rate limits →