How to Add an X API Credential
Create and add the X API credential Cortex uses for X profile, list, and search sources.
When You Need This Credential
Add an X API credential when your organization wants to use X Profile, X List, or X Search sources. Those source types require an active organization-scoped X credential before they can be activated.
You do not need this credential for RSS, Web, or API Endpoint sources.
What To Create In X
In the X Developer Portal, create or use an app that has at least Read permission. Cortex expects the four OAuth 1.0a values from that app:
- Consumer Key (API Key)
- Consumer Secret (API Key Secret)
- Access Token
- Access Token Secret
If you need to generate or review those values, use the X Developer Portal.
Who Can Add It In Cortex
Organization admins manage X credentials for the whole organization. Members can see credential posture, but they cannot add or rotate the credential.
How To Add It In Cortex
- Open Settings -> Credentials.
- Find the X API Credentials section.
- Paste the consumer key, consumer secret, access token, and access token secret.
- Click Save Credentials.
Cortex stores one active X credential set per organization. Saving new values rotates the previous credential.
How Cortex Validates It
When you save the credential, Cortex validates it by calling GET /2/users/me
against the X API. That catches invalid or expired credentials before you depend on them in
live source polling.
How Cortex Uses It
Cortex reuses the credential across all X-backed sources in the same organization. Once the credential is active, you can attach it indirectly by creating X Profile, X List, and X Search sources.
What Happens Without It
If your organization has no active X credential, Cortex blocks activation of X-backed sources and points admins back to Settings -> Credentials.