X (Twitter): coming soon

Coming soon. X is not available yet: X accounts cannot be connected in production, so none of the endpoints or tools below work against X today. This page describes the planned integration and may change before launch.

When X launches, Postgale will publish to X with the X API v2: posts, threads, polls, quotes, replies, images, GIFs and videos, with replies, metrics, mentions and direct messages. Everything is available over the REST API (paths relative to https://staging.postgale.com/api/v1) and the MCP server (create_post, list_comments, moderate_comment, get_analytics, send_message, start_conversation, x_engagement, x_search_posts, x_lookup). Each connected X user will be one account with platform x.

Connect an accountCopy Anchor Link

Ask for a connect link and send the account owner to it. They authorize Postgale on X (OAuth 2.0); tokens are stored encrypted and refreshed automatically.

curl https://staging.postgale.com/api/v1/connect/x?externalId=cust-1 \
  -H 'Authorization: Bearer sk_…'

# {"authUrl":"https://x.com/i/oauth2/authorize?…","expiresInSeconds":600}

PublishCopy Anchor Link

Text is limited to 280 weighted characters (URLs count 23, emoji and CJK characters 2), or 25,000 for accounts with an X Premium subscription. The limit is checked when the post is created. Videos are processed by X after upload; while that runs the target stays publishing and the worker finishes it.

curl -X POST https://staging.postgale.com/api/v1/posts \
  -H 'Authorization: Bearer sk_…' \
  -H 'Content-Type: application/json' \
  -d '{"content":"We just shipped scheduled threads 🧵","platforms":[{"accountId":"acc_x","platformSpecificData":{"threadItems":[{"content":"We just shipped scheduled threads 🧵"},{"content":"Write the thread once, pick a time, done.","mediaUrl":"https://media.postgale.com/demo.png","altText":"Thread editor"}],"replySettings":"following"}}],"publishNow":true}'

curl -X POST https://staging.postgale.com/api/v1/posts \
  -H 'Authorization: Bearer sk_…' \
  -H 'Content-Type: application/json' \
  -d '{"content":"Which feature next?","platforms":[{"accountId":"acc_x","platformSpecificData":{"poll":{"options":["Bluesky","LinkedIn","YouTube"],"duration_minutes":1440}}}],"publishNow":true}'

EndpointsCopy Anchor Link

Direct messagesCopy Anchor Link

X has no 24-hour messaging window: you can message anyone whose DM settings accept messages from the account, and only X lets you write first. Start with POST /inbox/conversations, then reply with POST /inbox/conversations/{id}/messages. Encrypted X Chat conversations are not available through the X API.

curl -X POST https://staging.postgale.com/api/v1/inbox/conversations \
  -H 'Authorization: Bearer sk_…' \
  -H 'Content-Type: application/json' \
  -d '{"accountId":"acc_x","participantUsername":"happy_customer","text":"Thanks for the shoutout! Here is 20% off: THANKS20"}'

Comments, mentions and inbound eventsCopy Anchor Link

Replies to your posts are listed from X's recent search (the last 7 days). When the instance enables the inbox poll (X_INBOX_POLL_MINUTES), new replies arrive as comment.received, other mentions as mention.received, and DMs as message.received webhooks.

X's rules to knowCopy Anchor Link

• Replies: X only accepts API replies to a post whose author mentioned or quoted the account (or in the account's own conversations). Other replies fail with 403.
• Likes, follows and quote posts are restricted by X to Enterprise API access; they may fail with missing_permission.
• Edits need X Premium and must happen within 1 hour (up to 5 times); X gives the edited post a new id.
• Costs: X bills every API call (posts, reads, DMs) to the app. Posts containing a link cost noticeably more on X's side.
• Rate limits (per account, 15 minutes): 100 posts, 50 deletes, 15 DM sends; 429 answers rate_limited.