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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.meeds.io/meeds-guides/admin-guide/propose-actions-to-achieve/gamification-connectors/x-twitter.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.