Inbox

Inbox

Included — Inbox (DMs, comments, reviews) is bundled with every account on the Usage plan. X DM sends bill at X's pass-through rate, not on the outbound message meter.

X (Twitter) 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!"
  }'

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.