Connect an X account to Iris AI
Applies to: Iris AI. Last reviewed: November 2026.
Connecting an X account brings your brand's posts, replies, mentions and (optionally) direct messages into Iris AI, and lets your agents reply on X. X connections use your own X developer app: you create it in the X Developer Portal, choose an X API plan, and give its keys to Iris AI.
Before you start
- Admin access to Iris AI (Account Admin, or Source Integration Admin).
- An X developer account and app, created at developer.x.com while signed in as (or with access to) your brand's X account.
- An X API plan that includes the access you need. Iris AI uses the X API v2, including the filtered stream for real-time collection. X sets the plans, prices and limits, and bills you directly; check the current options in the X Developer Portal. Some actions, such as liking or quoting posts, need X's higher tiers.
- The app's keys, from X Developer Portal > your app > Keys and tokens:
- API Key and API Key Secret (also called Consumer Key and Secret)
- Bearer Token
- Access Token and Access Token Secret for your brand's account, generated with Read and write permission (add Direct Messages permission if you want DMs). These are needed to reply and to receive DMs.
- Your monitoring plan: the brand handles to follow, and any keywords, hashtags or other handles to track.
Keep the keys somewhere safe, such as your password manager. If you regenerate them in X later, update them in Iris AI too.
Step 1: Start the wizard
Go to Admin > Social Connections, select Deploy New Connection, then X.
Choose a platform: X
Step 2: Accept the deployment agreement
Read the agreement, tick the box and select I Agree & Continue. It confirms that you are the authorized holder of the X API credentials and that your use follows the X Developer Agreement and Policy.
X deployment agreement
Step 3: Enter your X app credentials
Paste each key into its field: API Key, API Secret, Access Token, Access Token Secret and Bearer Token. Tip: if you copied the keys as one block, paste it into API Key and Iris AI fills in the other fields.
Select Test Connection. When it shows Valid with your account's handle, select Continue to Monitoring.
X credentials with a successful test
If the test fails, check that you copied each key completely, that the app belongs to a project with X API v2 access, and that the access token was generated after you set the app's permissions.
Step 4: Choose what to monitor
| Field | What it collects |
|---|---|
| Brand X Handles | Your brand's own posts, all replies to them (including nested replies), and @mentions of your brand. Each person's replies to a brand post become their own case, linked to that post. |
| Keywords | Any public post containing these terms. Posts from the same person are grouped into one case. |
| Hashtags | Any public post using these hashtags. |
| Mentions | Public posts that mention other handles, for example a product or support handle you don't log in to, or competitors. |
X monitoring rules
Every post collected counts towards your X API usage, so start with your brand handles and add keywords carefully.
Step 5: Choose features
- Collect Tweets (always on): real-time collection of the handles, keywords and hashtags you chose.
- Direct Messages: receive and answer DMs sent to your brand account.
- Publishing: reply to posts and mentions from Iris AI.
- Load Historical Data: a one-time import of past posts for your handles when the connection is deployed. This uses X's full-archive search, which your X plan must include and which counts towards your X usage.
X features
Step 6: Review and deploy
Check the summary, optionally name the connection, and select Deploy.
Review and deploy
Step 7: Check that it works
- On Social Connections, the X card shows ACTIVE.
- Mention your brand handle from another X account. The post appears in Agent within seconds, with the X icon.
- Reply to it from Iris AI and confirm the reply shows on X.
Keeping it running
- If you regenerate keys or tokens in X, update them from the connection's View Details page.
- If collection stops, check your X plan's usage and status in the X Developer Portal first.
Next: set up routing for X conversations (Routing work in Iris AI: tags, work queues, priority and smart views).