Your X API keys
The agent runs on the four keys of an X developer app you own. Deploying checks only that each field is filled in.
The agent runs on the four keys of an X developer app you own. Deploying checks only that each field is filled in.
The four keys
Each agent runs on the keys you enter. There are no shared keys.
Getting the keys on X
- Open developer.x.com → Projects & Apps and open your app.
- Set the app's permissions to Read and write.
- Open Keys and tokens.
- Copy the API key and the API key secret.
- Generate the access token and secret, then copy both.
The fields on the card
| Setting | Value |
|---|---|
| API Key (Consumer Key) | The app's API key |
| API Key Secret (Consumer Secret) | The app's API key secret |
| Access token | The access token generated after setting Read and write |
| Access token secret | The secret that belongs to the access token |
Warning
Use an X developer app that is used for nothing else. The agent replaces every filtered-stream rule on that app with its own.
Where you enter them
| Where | Label | When |
|---|---|---|
| Onboarding, after payment | Connect your X account card, button Deploy X Agent | First deploy |
| Management → Profile | Set up X agent | The agent shows Setup required |
| Management → Profile | Retry provisioning | The deploy failed |
| Whitelist and Metrics tabs | Re-enter keys | The agent is offline because a key is missing |
The deploy button stays disabled until all four fields are filled. Spaces around a key are removed.
What is checked
At deploy, the only check is that each of the four fields is filled. The keys are not tested with X.
A deploy with wrong keys still finishes. The agent then cannot connect to X and shows Idle.
Re-enter keys also checks the format. Each key must be 8 to 256 characters with no spaces. A key that fails shows an error in the dialog.
Replacing keys
Re-enter keys appears only when a key is missing. It does not appear for keys that are filled in, including wrong or revoked ones.
To replace keys that are filled in, open a ticket in the Support tab. The Support tab shows with the switch set to Twitter.
X API billing
X bills you directly for X API usage. The Metrics tab shows an estimate only.