# Setup X Integration

There are **two ways** to integrate with X:

1. Use your own X Developer Account
2. Use Holoworld's X API (whitelisted partners only for now)

<figure><img src="https://3847104975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx3XJPuHjcm9UuQOCtVEu%2Fuploads%2FyMhkudn25nLWImrFa0O3%2FScreenshot%202025-01-14%20at%203.40.43%E2%80%AFAM.png?alt=media&#x26;token=d84d7d40-7df6-4fc2-84fa-30b11035f956" alt=""><figcaption></figcaption></figure>

### Option 1: Use Your Own X Developer Account

* Go to the [X Developer Portal](https://developer.x.com/en) homepage.
* Click "Developer Portal" on the top right.
* Choose your plan to get started. You can click "Sign up for a Free Account" for a free quickstart

<figure><img src="https://3847104975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx3XJPuHjcm9UuQOCtVEu%2Fuploads%2FCk4we4621KIR2GZKblMl%2FScreenshot%202025-01-14%20at%204.02.30%E2%80%AFAM.png?alt=media&#x26;token=76ea2bdc-28ac-4da1-b766-66a544b8496e" alt="" width="375"><figcaption></figcaption></figure>

* In the dashboard, under the "Keys and tokens" tab, click "Regenerate" under "Consumer Keys".

<figure><img src="https://3847104975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx3XJPuHjcm9UuQOCtVEu%2Fuploads%2FzK0cN2AfPbk2Sm9aHH6v%2FScreenshot%202025-01-14%20at%204.06.48%E2%80%AFAM.png?alt=media&#x26;token=4a39e101-f108-4105-9572-1791a9e37f73" alt=""><figcaption></figcaption></figure>

* Copy "API Key" to the "Consumer Key" field on Holoworld
* Copy "API Key Secret" to the "Consumer Secret" field on Holoworld

<figure><img src="https://3847104975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx3XJPuHjcm9UuQOCtVEu%2Fuploads%2Fr8SFqJe5SRvRplA2fEXK%2FScreenshot%202025-01-14%20at%204.23.41%E2%80%AFAM.png?alt=media&#x26;token=e3de069b-a05c-4410-b24d-d0b1f609a3d0" alt=""><figcaption></figcaption></figure>

* Go back to the dashbaord, and under "Settings", click "Set up" under "User Authentication Settings".

<figure><img src="https://3847104975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx3XJPuHjcm9UuQOCtVEu%2Fuploads%2FV8jPA0G9SIRIsj1gguN3%2FScreenshot%202025-01-14%20at%204.28.12%E2%80%AFAM.png?alt=media&#x26;token=2d0fa94e-3462-4199-94f0-5d48631862b6" alt=""><figcaption></figcaption></figure>

* Fill out the checkboxes as follows: Read and write + Web App, Automated App or Bot

<figure><img src="https://3847104975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx3XJPuHjcm9UuQOCtVEu%2Fuploads%2FOp4KzgrZ40A03Qk9wfap%2FScreenshot%202025-01-14%20at%204.29.42%E2%80%AFAM.png?alt=media&#x26;token=1e130956-6aef-4bcd-9a14-caf6647c6594" alt=""><figcaption></figcaption></figure>

* Copy and paste the redirect URL from Holoworld to the "App Info" section on X, and add a website URL. Press "Save".
* Go back to Holoworld, and press "Connect". If everything works as expected, you should be redirected to the Agent Dashboard page!

### Option 2: Use Holoworld's X API

Please reach out via Discord to apply for Holoworld's X API whitelist.