Send DMs & read replies

Send direct messages from a connected account and read the resulting conversations.

Send a DM

POST/v1/dm/send10 credits

Target a recipient by recipient_username or recipient_id. Every write requires an Idempotency-Key header so a retried request never sends twice.

curl -X POST https://api.xautodm.com/v1/dm/send \
  -H "Authorization: Bearer $XAUTODM_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"account_id":"acc_1a2b3c","recipient_username":"jack","text":"Hey — loved your post on X automation."}'

Field	Type	Required	Description
`account_id`	string	Required	The connected account to send from.
`recipient_username`	string	Optional	Recipient handle. Provide this or `recipient_id`.
`recipient_id`	string	Optional	Recipient numeric user id.
`text`	string	Required	The message body.

Response:

Response

{
  "data": { "sent": true, "message_id": "1750..." },
  "meta": { "credits_charged": 10, "credits_remaining": 4990, "request_id": "req_..." }
}

Respect X's limits. Sending too many DMs too fast risks the account — pace your sends and personalize each message.

List conversations

GET/v1/dm/conversations10 credits

List DM threads for a connected account. Pass account_id as a query param, optionally tab=all|requests|hidden.

curl https://api.xautodm.com/v1/dm/conversations?account_id=acc_1a2b3c \
  -H "Authorization: Bearer $XAUTODM_API_KEY"

Read a conversation

GET/v1/dm/conversations/{id}10 credits

Fetch one thread's messages. Use this to detect replies and build an inbox or auto-responder on top of the API.

curl https://api.xautodm.com/v1/dm/conversations/CONV_ID?account_id=acc_1a2b3c \
  -H "Authorization: Bearer $XAUTODM_API_KEY"

Scrape leads →Idempotency & retries →