X (Twitter)
The X connector gives the CMO a posting and measurement surface on X: single posts, chained threads of up to 10 posts, media attachments, replies, and public engagement metrics that feed channel-performance scoring.
Before you start
Section titled “Before you start”- Plan: any plan. Counts as one integration toward your plan’s quota.
- An X developer app with OAuth 2.0 enabled and a user access token
for the account you want the CMO to post from. Generate the token with the
scopes
tweet.read tweet.write users.read media.write offline.access(the platform’s own authorization flow uses exactly this scope set with PKCE). - The token you paste is used as-is against the X API v2. X user tokens
expire after 2 hours; when the connector receives a
401it reportserrorand you re-authorize by pasting a fresh token via Reconnect. The permission policy survives the reconnect. A429puts the connector intorate_limiteduntil the next successful call.
Connect
Section titled “Connect”- Open Settings → Connectors and click + on X (Twitter).
- Paste the token into Provider access token and click Verify and
connect. The platform calls
GET /2/users/me; if X rejects the token, nothing is saved. - X appears under Connected.
Connector tools
Section titled “Connector tools”| Tool | Action | What it does |
|---|---|---|
get_account |
read | Inspect the authenticated X account |
get_post |
read | Verify a known post and its account ownership |
create_tweet |
create | Post a tweet, optionally with media or as a reply |
create_thread |
create | Post a sequence of chained tweets as a thread (max 10) |
upload_media |
create | Upload media for attachment to tweets |
get_engagement |
read | Public engagement metrics for a tweet |
delete_tweet |
delete | Delete a tweet by ID |
Permissions
Section titled “Permissions”See Permission model. Posting uses the
create action and is allowed on every plan, subject to the Quality Gate,
brand-voice match, and your autonomy level. delete_tweet uses delete:
unavailable on Starter and Professional, approval-gated on Business.
Disconnect
Section titled “Disconnect”Click the trash icon on the X row and confirm; the token is revoked from the vault. Revoke the app’s access under Settings → Security and account access → Apps and sessions on X as well.