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

# X Connection Setup

> Connect X (Twitter) Ads to Whathead: sign in with X, then choose the ad accounts, pixels, promotable users and apps Whathead can use.

You connect X Ads by signing in with an X account that has access to your X ad accounts. After sign-in, Whathead asks you to choose which X assets it can use.

## Before you start

* You are the **owner** of your Whathead workspace. Only the workspace owner can connect platforms.
* Your workspace has an active trial or subscription. Without one, Integrations shows "Start a trial or subscription before connecting platforms."
* The X account you sign in with can access the ad accounts you want to manage.

## Connect

**1. Open Integrations**

In Whathead, go to **Integrations** and find the **X (Twitter) Ads** card.

**2. Sign in with X**

Click **Connect**. X opens its authorization page. Sign in and authorize Whathead.

**3. Select X assets**

Back in Whathead, the **Select X Assets** page lists what your login can reach. Choose:

* **Ad Accounts**
* **Pixels (Tracking Tags)**: web event tags configured on your X ad accounts
* **Promotable Users**: X handles you can promote posts for or drive followers to
* **Apps**: mobile apps registered on each ad account, used by app install and app engagement campaigns

**4. Save**

Save your selection. The assets you selected are now available in Whathead, including the campaign builder and the AI assistant.

> [!TIP]
>
> Whathead's AI assistant can only use X accounts that are connected and selected here. Connect X first, then [connect your assistant](https://docs.whathead.com/ai-assistant/connect.md).

## Troubleshooting

* **An ad account is missing.** Check that the X login you used has access to it in X Ads Manager, then reconnect and select it.
* **A promotable user is missing.** The handle must be a promotable user on that ad account in X Ads.

## Related

> [card] [X Ads overview](https://docs.whathead.com/platforms/x/overview.md)
>
> What you can do with X Ads in Whathead.

> [card] [Connection issues](https://docs.whathead.com/troubleshooting/connection-issues.md)
>
> General fixes for platform connections.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.