Platforms
X
X over the overads API: status, connection, limits, media rules and platformSettings keys.
Status: Live. Posts created over the API deliver to this channel today.
Publishes today.
The API id for X is twitter: use it in platformSettings, variants, platform filters and in the platforms array on a post.
Connecting
OAuth through X, in the app.
Once connected the account appears in GET /connections with platform: "twitter". Use its id in connectionIds.
Limits
| Characters | 280, counted the way X counts: Chinese, Japanese and Korean characters and every emoji count 2, and every link counts 23 whatever its length. |
| API id | twitter |
- Up to 4 images, or 1 video up to 512 MB and 140 seconds.
- Media is optional.
Limits are checked when the post is created or edited, so an over-limit post is refused then with a sentence naming the cap, not at the scheduled minute. These refusals answer 400 with the flat body { statusCode, code, message }, not the { error } envelope: TOO_LONG, TOO_MANY_ITEMS, MEDIA_UNSUPPORTED, MEDIA_REQUIRED, MEDIA_TOO_LARGE (over the channel's video size cap), MEDIA_TOO_LONG (over its duration cap). The full list is under Channel-limit refusals.
Settings
Pass these under platformSettings.twitter. Every key is optional. An unknown key is refused with PLATFORM_SETTING_UNKNOWN and the dotted path of the key.
| Key | Value | Meaning |
|---|---|---|
replyTo | string, up to 64 | Id of the post to reply to |
quoteTweet | string, up to 64 | Id of the post to quote |
{ "twitter": { "quoteTweet": "1834567890123456789" } }