> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mantle.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# X (Twitter)

> Post tweets and upload media on the X platform (free tier)

Connect your X (Twitter) account and give your agents the ability to post tweets, upload media, and look up your account
information. This integration uses the free API tier, which provides write access and basic account lookup.

***

## What you unlock

<CardGroup cols={2}>
  <Card title="Post tweets" icon="feather">
    Compose and publish tweets directly from Mantle — text, threads, or media posts.
  </Card>

  <Card title="Upload media" icon="image">
    Upload images and videos to attach to tweets before publishing.
  </Card>

  <Card title="Account lookup" icon="circle-user">
    Retrieve your own account details including username, bio, and follower count.
  </Card>
</CardGroup>

***

## Connect X (Twitter)

<Steps>
  <Step title="Open Settings → Integrations">
    In any workspace go to **Settings → Integrations** and select **X (Twitter)**.
  </Step>

  <Step title="Authorize with X">
    Click **Connect** and sign in with your X account. Grant the requested permissions so Mantle can post and upload
    media on your behalf.
  </Step>

  <Step title="Add X to an agent">Open the agent and enable only the X actions it needs.</Step>
</Steps>

<Note>
  This integration uses the X API **free tier**, which supports posting tweets, uploading media, and looking up your own
  account. Read endpoints (searching tweets, reading timelines, looking up other users) require a paid API plan and are
  not included.
</Note>

***

## Agent tools

### Posting

| Tool         | Description                                   |
| ------------ | --------------------------------------------- |
| Create post  | Compose and publish a new tweet               |
| Upload media | Upload an image or video to attach to a tweet |

### Account

| Tool             | Description                                          |
| ---------------- | ---------------------------------------------------- |
| User lookup (me) | Retrieve the connected account's profile information |

***

## Triggers

<Note>
  Triggers are not yet available for X (Twitter). When trigger support is added, you will be able to start agent tasks
  automatically based on activity on your account.
</Note>

***

## Example use cases

<AccordionGroup>
  <Accordion title="Post a product announcement">
    Give your agent the key details — feature name, benefit, and a link — and have it draft and publish a tweet with the
    right tone and hashtags.
  </Accordion>

  <Accordion title="Publish a visual update with media">
    Upload a screenshot or graphic, then have the agent compose a tweet with the media attached to announce a milestone
    or share progress.
  </Accordion>

  <Accordion title="Cross-post content from another channel">
    After publishing a LinkedIn post or blog article, ask your agent to create a concise tweet summarizing the content
    with a link back to the original.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="OAuth flow fails or is denied">
    Make sure you are signing in with the correct X account. If the flow fails, try disconnecting and reconnecting from
    **Settings → Integrations → X (Twitter)**.
  </Accordion>

  <Accordion title="Tweets fail with a permissions error">
    The free API tier supports posting but has rate limits. If you hit the limit, wait 15 minutes and try again. Check
    the [X API rate limits](https://developer.x.com/en/docs/x-api/rate-limits) for current thresholds.
  </Accordion>

  <Accordion title="Cannot search tweets or read timelines">
    The free tier only includes write access and basic account lookup. Searching tweets, reading timelines, and looking
    up other users require a paid X API plan.
  </Accordion>

  <Accordion title="Media upload fails">
    Ensure the file meets X's media requirements: images must be PNG, JPEG, GIF, or WebP (max 5 MB); videos must be MP4
    (max 512 MB). Animated GIFs are limited to 15 MB.
  </Accordion>
</AccordionGroup>

***

<Card title="Back to Integrations" icon="plug" href="/integrations/overview">
  View all available integrations
</Card>