# 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="https://3823946396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i2FMkbhfl9LXQQfUyES%2Fuploads%2Fq6YUNJmY1nBbhtBHNEcY%2FTwitter-Connector-home.png?alt=media&#x26;token=de36590b-39d8-4d44-b4ce-c6f01e0e2854" alt="" width="563"><figcaption><p>List of events supported by the X connector</p></figcaption></figure>

Next, click `Configure`

<figure><img src="https://3823946396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i2FMkbhfl9LXQQfUyES%2Fuploads%2Fw8bZnCmnnV6W0cxAAYYs%2FTwitter-connector-configure.png?alt=media&#x26;token=bc3cc8ca-74a7-4cee-b944-2c5231612e37" 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="https://3823946396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i2FMkbhfl9LXQQfUyES%2Fuploads%2FVEblq8pv2JJWZdBQYAFa%2FTwitter-connector-profile-step1.png?alt=media&#x26;token=6a9f7482-b2de-4c89-9043-8d7066c840b2" 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="https://3823946396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i2FMkbhfl9LXQQfUyES%2Fuploads%2F7A4PZ8E7uWWKycXQSHCz%2FTwitter-developer-portal.png?alt=media&#x26;token=3caf147a-7aba-4dce-8871-2421c6b69d52" 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="https://3823946396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i2FMkbhfl9LXQQfUyES%2Fuploads%2FqLLxxfMOHMIiidmB0CpM%2FTwitter-app-permissions.png?alt=media&#x26;token=3a578bde-adf9-42bf-9c5b-09be7305c726" alt="" width="375"><figcaption><p>Set Read permission</p></figcaption></figure>

<figure><img src="https://3823946396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i2FMkbhfl9LXQQfUyES%2Fuploads%2Fmk86toDgwtpnEvzLLIuq%2FTwitter-app-type.png?alt=media&#x26;token=9772fde2-5a1b-4ec2-9736-0b23d102815b" 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="https://3823946396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i2FMkbhfl9LXQQfUyES%2Fuploads%2FH3HIdAiIoRNOMiFzwn59%2FTwitter-connector-profile-step2.png?alt=media&#x26;token=0dbd8bc5-c0ae-4068-b2ea-4f2d27e4b1ab" alt="" width="375"><figcaption><p>Copy Callback URI and Website URL in Meeds (2/3)</p></figcaption></figure>

<figure><img src="https://3823946396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i2FMkbhfl9LXQQfUyES%2Fuploads%2FyrE29EooHCHqS7Ed3PgT%2FTwitter-app-info.png?alt=media&#x26;token=d5d3d489-2694-42b1-8637-d90b0025e58e" 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="https://3823946396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i2FMkbhfl9LXQQfUyES%2Fuploads%2FsTiyP6b0f3lQ5Imqirw1%2FTwitter-connector-profile-step3.png?alt=media&#x26;token=5b1ea676-89d0-46df-ac13-8638dc781a0b" alt="" width="375"><figcaption><p>Enter Client credentials in Meeds (3/3)</p></figcaption></figure>

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

<figure><img src="https://3823946396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i2FMkbhfl9LXQQfUyES%2Fuploads%2FP7RJIHaV09knkLMbHk0b%2FTwitter-connector-profile-ok.png?alt=media&#x26;token=6c0248d2-579f-4123-b647-89508eebce5b" alt="" width="563"><figcaption><p>Connect  Twitter profile configured</p></figcaption></figure>

You can click on the <img src="https://3823946396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i2FMkbhfl9LXQQfUyES%2Fuploads%2FldWgltz67X5RUxd1VmlL%2Ftoggle.png?alt=media&#x26;token=b89d21c1-040f-4d83-8df1-0dd1d8e2760d" 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="https://3823946396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i2FMkbhfl9LXQQfUyES%2Fuploads%2FUyAGDRoQVEPeGWXOaLeJ%2FTwitter-connector-org.png?alt=media&#x26;token=346c92ee-219b-47c3-a215-5e6473496dab" 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="https://3823946396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i2FMkbhfl9LXQQfUyES%2Fuploads%2FI9L95cZLLwkDA7m0Nbli%2FTwitter-app-tokens.png?alt=media&#x26;token=560195db-edf1-42fd-a450-7fdcdda7962a" 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="https://3823946396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i2FMkbhfl9LXQQfUyES%2Fuploads%2FRCfBswyboc0b8BJZDzvE%2FTwitter-app-bearer.png?alt=media&#x26;token=48c7f535-f11f-4681-acf5-5ab4d3f2c91f" 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="https://3823946396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i2FMkbhfl9LXQQfUyES%2Fuploads%2FqrS3BI7zervrQHKspiNO%2FTwitter-connector-addorg.png?alt=media&#x26;token=8248fc43-8ab2-4d02-81d9-46c6fb7ff31e" 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="https://3823946396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i2FMkbhfl9LXQQfUyES%2Fuploads%2FWHUlIIqsvi120uqlJQTx%2FTwitter-connector-meedsorg.png?alt=media&#x26;token=fce8d65a-3fb4-4487-8f34-c31ca3b66460" 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="https://3823946396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i2FMkbhfl9LXQQfUyES%2Fuploads%2FYeH6neDNfWdaOWJbjT5V%2FTwitter-connector-org-events.png?alt=media&#x26;token=c73d73ed-5699-4e16-bd04-03cc641039cc" 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)***](https://docs.meeds.io/meeds-guides/admin-guide/designing-incentives/growing-your-audience-on-x)***.***
