​

X / Twitter

​

API overview

​

Use cases

• Publish short text updates with or without media.
• Attach images or videos to a social post.
• Use one connected account for recurring publishing workflows.

​

When to use

• When the content is a standard social post with text and optional media.

​

When not to use

• When you need provider-specific metadata fields or long-form video publishing.

​

Examples

​

Text post with media

{
  "platforms": [
    {
      "platform": "twitter",
      "accountId": "x_123",
      "content": "New docs update is live.",
      "mediaItems": [
        {
          "type": "image",
          "url": "https://cdn.postova.dev/docs-card.png"
        }
      ]
    }
  ]
}

​

How to post

1. Connect an X account with write access.
2. Create the post content and any attached media.
3. Publish to the connected X account.

​

Authentication

​

Default scopes

​

Supported media

• text
• image
• video
• Supports text, image, and video publishing.

​

Settings

​

Common errors

• Write permission missing: The X account is connected without the necessary write scopes. Fix: Reconnect the account with the full publishing scopes.

​

Constraints

• No provider-specific publishing settings are currently exposed.

​

Notes

• Uses the standard X OAuth scopes including offline access.