> ## 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

> Authorizing X with Ayrshare

<Info>
  **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](/dashboard/connect-social-accounts/x-twitter-byo-keys) for step-by-step instructions.
</Info>

## 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.

<Steps>
  <Step title="Ayrshare Social Accounts Page">
    Click **X/Twitter - Click to Link** button on the Social Accounts page.

    <img class="center" width="400" src="https://mintcdn.com/ayrshare-docs/dKBti0xVDJrOZ19f/images/dashboard/x-twitter-click-to-link.webp?fit=max&auto=format&n=dKBti0xVDJrOZ19f&q=85&s=20a196ad48d91ff22f25f58c5d1d7b6a" alt="Click on X Click to Link" data-path="images/dashboard/x-twitter-click-to-link.webp" />
  </Step>

  <Step title="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 requires every Ayrshare user to provide their own X API credentials in order to link an X account.

    If you don't yet have these credentials, follow the [X BYO Key Setup Guide](/dashboard/connect-social-accounts/x-twitter-byo-keys) 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.

    <img class="center" width="400" src="https://mintcdn.com/ayrshare-docs/l1CVLz3RaF9NyPNv/images/dashboard/x-byok-modal.webp?fit=max&auto=format&n=l1CVLz3RaF9NyPNv&q=85&s=a729a68e01f527be25a18c62d9dde9d0" alt="Enter X Consumer Key and Secret" data-path="images/dashboard/x-byok-modal.webp" />
  </Step>

  <Step title="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.

    <img class="center" width="400" src="https://mintcdn.com/ayrshare-docs/dKBti0xVDJrOZ19f/images/dashboard/x-twitter-login.webp?fit=max&auto=format&n=dKBti0xVDJrOZ19f&q=85&s=efbe2aa315b03d5491e24f0b9640c3a4" alt="Login via X account" data-path="images/dashboard/x-twitter-login.webp" />
  </Step>

  <Step title="Authorize Access">
    If you have already signed in, click **Authorize app** on the pop-up.

    This will authorize Ayrshare to access your X account.

    <img class="center" width="300" src="https://mintcdn.com/ayrshare-docs/dKBti0xVDJrOZ19f/images/dashboard/x-twitter-authorize.webp?fit=max&auto=format&n=dKBti0xVDJrOZ19f&q=85&s=5362a332f3ec349a0b169174a554a1d7" alt="Click Authorize app" data-path="images/dashboard/x-twitter-authorize.webp" />
  </Step>

  <Step title="Confirmation">
    Your Social Accounts page will now be updated with your X account.

    <img class="center" width="300" src="https://mintcdn.com/ayrshare-docs/dKBti0xVDJrOZ19f/images/dashboard/x-twitter-linked.webp?fit=max&auto=format&n=dKBti0xVDJrOZ19f&q=85&s=f109df752f758fe82bf402fd69ed6ce8" alt="X Confirmation" data-path="images/dashboard/x-twitter-linked.webp" />
  </Step>
</Steps>

## Additional X Information

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

<Card title="Image and Video Guidelines" icon="link" href="/media-guidelines/x_twitter" horizontal />