GetXAPI
DM

DM Send

Send Twitter direct messages programmatically via API. $0.002 per call. GetXAPI DM send endpoint documentation with code examples.

POST/twitter/dm/send

This endpoint costs $0.002 per API call.

Request Body

FieldTypeRequiredDescription
auth_tokenstringYesUser's auth token
ct0stringNoOptional current CSRF token cookie. When provided with twid, skips server-side credential resolution.
twidstringNoOptional current user ID cookie, for example u=1234567890. Must be provided with ct0.
recipient_idstringNoRecipient user id
recipient_usernamestringNoRecipient username (without @)
textstringYesMessage text
proxystringNoProxy URL (http://, https://, socks5://, or socks4://)

Notes

  • If you already have current ct0 and twid, send both to skip the extra server-side credential bootstrap from auth_token. If either one is omitted, the server resolves them from auth_token as before. Stale or invalid supplied values are not validated upfront and may fail on the actual Twitter action instead of returning an early 401.
  • Provide either recipient_id or recipient_username.
  • If recipient_username is used, it is resolved to a user id via the pool.

Response (200)

{
  "status": "success",
  "msg": "DM sent successfully",
  "data": {
    "id": "2019384131067818211",
    "createdAt": "2026-02-05T12:14:29.846Z",
    "senderId": "1858475867762270208",
    "recipientId": "1234567890123456789",
    "text": "Hello!",
    "recipient_username": "target_user"
  }
}

Error Responses

400 - Missing fields

{
  "error": "Missing required field: recipient_id or recipient_username"
}

Example

curl -X POST "https://api.getxapi.com/twitter/dm/send" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "auth_token": "your_auth_token",
    "recipient_username": "target_user",
    "text": "Hello!"
  }'

# With recipient_id
curl -X POST "https://api.getxapi.com/twitter/dm/send" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "auth_token": "your_auth_token",
    "recipient_id": "1234567890123456789",
    "text": "Hello!"
  }'
const response = await fetch("https://api.getxapi.com/twitter/dm/send", {
  method: "POST",
  headers: {
    Authorization: "Bearer API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    auth_token: "your_auth_token",
    recipient_username: "target_user",
    text: "Hello!",
  }),
});
const data = await response.json();
console.log(data);
import requests

response = requests.post(
    "https://api.getxapi.com/twitter/dm/send",
    headers={"Authorization": "Bearer API_KEY"},
    json={
        "auth_token": "your_auth_token",
        "recipient_username": "target_user",
        "text": "Hello!",
    },
)
print(response.json())

DM ConversationNew

Fetch the full message history of a single Twitter DM conversation via API, newest first with cursor pagination. $0.001 per call. GetXAPI DM conversation endpoint docs.

Upload MediaNew

Upload an image, GIF, or video to Twitter/X and get a media_id for tweets via API. $0.001 per call. GetXAPI media upload endpoint.

On this page

Request Body
Notes
Response (200)
Error Responses
400 - Missing fields
Example