Inbox

Inbox

Included — Inbox (DMs, comments, reviews) is bundled with every paid account on the Usage plan.

Twitter/X supports DMs and comments through the unified Inbox API.

Direct Messages

Create conversation (send a DM)

Use POST /v1/inbox/conversations to start a new DM conversation (or append to an existing thread).

Note: X DM write endpoints require X API Pro tier ($5,000/month) or Enterprise access. This applies to BYOK users who provide their own X API credentials.

Note: By default, Zernio checks DM eligibility (recipient receives_your_dm). If the recipient does not accept DMs, the API returns 422 with code DM_NOT_ALLOWED. You can skip this check with skipDmCheck: true.

curl -X POST https://zernio.com/api/v1/inbox/conversations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "YOUR_ACCOUNT_ID",
    "participantUsername": "targetuser",
    "message": "Hello from Zernio Inbox API!"
  }'

const result = await zernio.messages.createInboxConversation({
  accountId: 'YOUR_ACCOUNT_ID',
  participantUsername: 'targetuser',
  message: 'Hello from Zernio Inbox API!'
});

console.log('DM sent:', result.data.conversationId, result.data.messageId);

result = client.messages.create_inbox_conversation(
    account_id="YOUR_ACCOUNT_ID",
    participant_username="targetuser",
    message="Hello from Zernio Inbox API!"
)

print("DM sent:", result["data"]["conversationId"], result["data"]["messageId"])

Comments

Limitations

• Encrypted X Chat DMs not accessible - X has replaced traditional DMs with end-to-end encrypted "X Chat" for many accounts. Messages sent or received through encrypted X Chat are not returned by X's API. This means some conversations may show only outgoing messages or appear empty. This is an X platform limitation that affects all third-party applications.
• DM permissions - DMs require dm.read and dm.write scopes
• Reply search - Uses cached conversation threads (2-min TTL) to manage rate limits
• Cached DMs - Conversations are cached with a 15-min TTL

See Messages and Comments API Reference for endpoint details.