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

# X Linking

> Link an X (Twitter) account to Ayrshare by entering your X Consumer Key and Consumer Secret, signing in through the pop-up, and authorizing the app.

> [!NOTE]
>
> **Starting March 31, 2026**, X requires your own API credentials for all operations through Ayrshare. If you are an API user, you can start using your own credentials immediately. See the [X BYO Key Setup Guide](https://www.ayrshare.com/docs/dashboard/connect-social-accounts/x-twitter-byo-keys.md) for step-by-step instructions.

## How to Link X (Twitter) with Ayrshare

You can link X, formerly known as Twitter, account with Ayrshare.
When authorizing X with Ayrshare, you will be redirected to X to login and authorize Ayrshare to access your X account.

**1. Ayrshare Social Accounts Page**

Click **X/Twitter - Click to Link** button on the Social Accounts page.

![Click on X Click to Link](https://mintcdn.com/ayrshare-docs/g_Qu9NNvmnPtA4bJ/images/dashboard/x-twitter-click-to-link.webp?fit=max\&auto=format\&n=g_Qu9NNvmnPtA4bJ\&q=85\&s=03e611f505591b4881995b3f7bd66823)

**2. Provide Your X API Credentials**

Before linking, you'll be prompted to enter your **X Consumer Key** (API Key) and **X Consumer Secret** (API Secret). X now requires every Ayrshare account to register one X Developer App and provide its API Key and API Secret in order to link an X account.

> [!NOTE]
>
> **One-time setup per Ayrshare account.** You create your X Developer App **once**, and the same API Key + API Secret are used for every X account you link going forward, including any sub-profiles or end-users. You do **not** create a separate developer app per customer.

If you don't yet have these credentials, follow the [X BYO Key Setup Guide](https://www.ayrshare.com/docs/dashboard/connect-social-accounts/x-twitter-byo-keys.md) to create an X Developer App and retrieve your API Key and API Secret. Paste both values into the modal, then continue to link your account.

![Enter X Consumer Key and Secret](https://mintcdn.com/ayrshare-docs/l1CVLz3RaF9NyPNv/images/dashboard/x-byok-modal.webp?fit=max\&auto=format\&n=l1CVLz3RaF9NyPNv\&q=85\&s=a729a68e01f527be25a18c62d9dde9d0)

**3. First Time X Linking**

When you click the X icon on the Social Accounts page, an X
sign-in will pop-up - *please be sure you allow pop-ups*. If you are already
logged in, please proceed to the following step.

Click *Sign In*, follow the instructions, and input relevant login credentials.

![Login via X account](https://mintcdn.com/ayrshare-docs/dKBti0xVDJrOZ19f/images/dashboard/x-twitter-login.webp?fit=max\&auto=format\&n=dKBti0xVDJrOZ19f\&q=85\&s=efbe2aa315b03d5491e24f0b9640c3a4)

**4. Authorize Access**

If you have already signed in, click **Authorize app** on the pop-up.

This will authorize Ayrshare to access your X account.

![Click Authorize app](https://mintcdn.com/ayrshare-docs/dKBti0xVDJrOZ19f/images/dashboard/x-twitter-authorize.webp?fit=max\&auto=format\&n=dKBti0xVDJrOZ19f\&q=85\&s=5362a332f3ec349a0b169174a554a1d7)

**5. Confirmation**

Your Social Accounts page will now be updated with your X account.

![X Confirmation](https://mintcdn.com/ayrshare-docs/dKBti0xVDJrOZ19f/images/dashboard/x-twitter-linked.webp?fit=max\&auto=format\&n=dKBti0xVDJrOZ19f\&q=85\&s=f109df752f758fe82bf402fd69ed6ce8)

## Additional X Information

* Please see here for details on
  [posting to X](https://www.ayrshare.com/docs/apis/post/social-networks/x-twitter.md),
  [getting analytics](https://www.ayrshare.com/docs/apis/analytics/overview.md),
  [managing comments](https://www.ayrshare.com/docs/apis/comments/overview.md), or
  [retrieving history.](https://www.ayrshare.com/docs/apis/history/overview.md)
* For more information on recommended image sizes, please see:

> [card] [Image and Video Guidelines](https://www.ayrshare.com/docs/media-guidelines/x-twitter.md)


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