> For the complete documentation index, see [llms.txt](https://docs.meeds.io/meeds-guides/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.meeds.io/meeds-guides/admin-guide/propose-actions-to-achieve/gamification-connectors/x-twitter.md).

# X (Twitter)

{% hint style="info" %}
This page applies to the **Business** and **Enterprise** plans.  [👉 Compare all plans](https://www.meeds.io/pricing)
{% endhint %}

If your organization uses X for general communication and wants to boost your audience's engagement, the X connector for Meeds is for you.

You can activate it to allow contributors to earn points by interacting with your accounts on X.

Events that the X connector can capture include:

* Likes
* Mentions
* Reposts

Go to *Administration > Recognition > Connectors > Twitter*

<figure><img src="/files/iih5I0IeaLZHukH3aM9b" alt="" width="563"><figcaption><p>List of events supported by the X connector</p></figcaption></figure>

Next, click `Configure`

<figure><img src="/files/z1eRrXvQTXxWVhzt1dsL" alt="" width="563"><figcaption><p>X connector ready to be configured</p></figcaption></figure>

## :point\_right: **Allow users to connect their X account**

Click on `Allow connection` *and* follow the instructions in the form to activate this connection

<figure><img src="/files/y0CnU5KDxcbpTbJ0H10D" alt="" width="375"><figcaption><p>Enable Twitter profile (1/3)</p></figcaption></figure>

**Step 1:** Create or connect to your account on the X [Developer portal](https://x.developer.com)

<figure><img src="/files/oFA5FSo4Enir4RPSKqbJ" alt="" width="563"><figcaption><p>Twitter Developer portal</p></figcaption></figure>

Create a project with *X API v2* access

:bulb: **Note:** *X requires a subscription to access its API, which is not free of charge. Hence, you must acquire at minimum a **Basic** plan to use the connector.*&#x20;

**Step 2:** Create a custom app and edit the *User authentication settings:*

<figure><img src="/files/PTwvDdJDQh1Vkv6CbKZT" alt="" width="375"><figcaption><p>Set Read permission</p></figcaption></figure>

<figure><img src="/files/bluQle1COImtwH1qsioO" alt="" width="375"><figcaption><p>Choose Web App type</p></figcaption></figure>

Fill in the *App info's* *Callback URL* and *Website URL* fields by copy-pasting the information from Meeds:

<figure><img src="/files/ySMvkM4VQbifvKrQGjzg" alt="" width="375"><figcaption><p>Copy Callback URI and Website URL in Meeds (2/3)</p></figcaption></figure>

<figure><img src="/files/MB2ycVOUvuHqJX8olkEK" alt="" width="375"><figcaption><p>Paste Callback URI and Website URL in X</p></figcaption></figure>

**Step 3:** Copy/paste the *Client ID* and *Client Secret and Save*

<figure><img src="/files/Y1RtBAqxDTQzr2rMkBk2" alt="" width="375"><figcaption><p>Enter Client credentials in Meeds (3/3)</p></figcaption></figure>

Once done, users can [connect their X account](/meeds-guides/user-guide/setting-up-your-account/linking-your-accounts/x-twitter.md) from their user settings.

<figure><img src="/files/VSE7euRUMqNlA4cxhVXF" alt="" width="563"><figcaption><p>Connect  Twitter profile configured</p></figcaption></figure>

You can click on the <img src="/files/sj3iPzbtlXkiV8bUaFP4" alt="" data-size="line">toggle button to temporarily disable profile connections, or you can ✏️ *Edit* or 🗑️ *Delete* the configuration to start over.

## :point\_right: **Add an X account to watch**

Next, tell Meeds which X account to watch for your organization. Click `Add Token`

<figure><img src="/files/9OZLVbqGbbMy7miOro89" alt="" width="375"><figcaption><p>Add token field in Meeds</p></figcaption></figure>

Go back to your app in the X Developer portal and click *Keys and tokens*

<figure><img src="/files/lTsE9dkBd6M5vffwOxKF" alt="" width="375"><figcaption><p>Keys and tokens in X</p></figcaption></figure>

In *Authentication Tokens > Bearer Token,* click `Regenerate` and confirm

<figure><img src="/files/6JetAWfZlJyXigMSt3mQ" alt="" width="375"><figcaption><p>Copy the bearer token in X </p></figcaption></figure>

Click `Copy`, then paste it into Meeds. Then, click on the  ✔️ green checkmark and `Save`

&#x20;Click on `Add account` and enter the X username of the organization to watch and `Save`

<figure><img src="/files/gcJ9pnCx3px5PrjFld2l" alt="" width="375"><figcaption><p>Enter the X account name</p></figcaption></figure>

Meeds is now ready to watch the organization's account.&#x20;

<figure><img src="/files/sllHETOW91BZ3FlBBDky" alt="" width="563"><figcaption><p>List of X accounts to watch</p></figcaption></figure>

Click on ➕ to add more accounts to watch and 🔑 to update your bearer token.

Optionally, you can click on the organization name and disable some events to watch specifically for that organization.

<figure><img src="/files/PQEHKxvi3ecjwnJF3HyN" alt="" width="563"><figcaption><p>List of events enabled for the X account</p></figcaption></figure>

***🎉 Congratulations! Your Meeds Hub is ready to boost your organization on X! Your program owner can now design incentives to***[ ***Grow your audience on X (Twitter)***](/meeds-guides/admin-guide/designing-incentives/growing-your-audience-on-x.md)***.***