X (Twitter) Ads
In one line: Connect X (Twitter) Ads so your UnleashX agent can look up your ad accounts, create and manage campaigns, and review line items — all in plain language.
1. Overview
X Ads (formerly Twitter Ads) is X’s advertising platform. It’s where you organize paid activity into ad accounts, campaigns, and the line items that carry your budgets, bids, and targeting across the X timeline. Once connected to UnleashX, your agent can list the ad accounts you can access, create and update campaigns, pause or delete campaigns, and review the line items underneath them. It works against your live X Ads account using your own X sign-in, so it respects your role and access. Connecting X Ads to UnleashX means you can manage paid campaigns as you talk. Instead of opening the Ads Manager to launch or adjust a campaign, you tell your agent and it makes the change — cutting the clicks while keeping your account accurate.2. What you’ll need
- An X Ads account with a payment method and at least one campaign-ready ad account.
- Ads API access approved for your account (X requires developer/API access for the Ads API).
- A funding instrument on the ad account — its
funding_instrument_idis required to create campaigns. - A user role with permission to create and edit campaigns on the ad account.
- An UnleashX account with access to Data Connectors.
No API key to paste. X Ads uses OAuth — you click Authorize and sign in with X.
3. Get your credentials
There’s no key to copy. Authentication runs through X’s secure OAuth sign-in.1
Start the connection in UnleashX
Connecting X Ads (Section 4) opens an X Authorize app window.
2
Sign in with X
Sign in with the X account that has access to your Ads account. Complete two-factor authentication if prompted.
3
Review and accept the access
X shows the access UnleashX is requesting (see the scopes table). Click Authorize app.
4
Confirm your ad account
If you can access several ad accounts, pick the one you want the agent to work with. UnleashX uses its ad account ID on every request.
5
Return to UnleashX
X redirects you back automatically and the connector links to your Ads account. UnleashX handles the OAuth token for you — you never paste or store it yourself.
X enforces the limits, not UnleashX. UnleashX requests only the access these tools need, and your X role still governs what you can do on each ad account.
4. Connect on UnleashX
1
Open your agent
Go to https://www.tryunleashx.com and open the agent you want to connect.
2
Open Data Connectors
Inside the agent, go to Data Connectors.
3
Find X (Twitter) Ads
Locate X (Twitter) Ads and click Connect (or Add / Configure).
4
Authorize with X
Click Authorize, sign in with X, accept the access, and pick your ad account.
5
Confirm success
You return to UnleashX and the X (Twitter) Ads connector shows a Connected badge.
Use X (Twitter) Ads in a Workflow
Once connected, you can add X (Twitter) Ads to any automation from the Workflows builder. Its triggers and tools appear in the Apps panel, marked with an MCP badge.1
Add a trigger node
Open Workflows → New Workflow. On the canvas, click + Add Trigger. In the Paths panel, open the Apps tab and select X (Twitter) Ads — its Triggers are listed underneath. Use the search box if you have many connectors.
2
Add an action node
Click the + below any node to add a step, then pick X (Twitter) Ads again — this time the panel lists its Actions.
3
Configure the step
Fill in the fields for the trigger or action you picked. Required fields are marked with a red asterisk (*).
4
Add or select your account
Under Selected account, choose an already-connected account, or click Add Account to connect one now.
5
Save and test
Click Save. Use Test to verify the step, then toggle Publish when the workflow is ready.
The steps are the same for every connector. For the full workflow builder guide, see Using MCP in Workflows.
5. Available tools
6. Example usage
“Create a new campaign called ‘Summer Launch’ on our main ad account with a $50/day budget.” → Runs List Accounts to find the ad account and its funding instrument, then Create Campaign with the budget set to50000000 (local micro amounts).
“Pause the ‘Spring Promo’ campaign — we’re out of budget.”
→ Runs List Campaigns to find the campaign, then Update Campaign to set its status to paused.
7. Permissions & data access
UnleashX can:- List the ad accounts, campaigns, and line items you can access.
- Create and update campaigns on your ad account.
- Delete campaigns where your role allows (this tool is clearly marked ⚠️).
- Do anything your X Ads role or account access doesn’t permit.
- Act on ad accounts you can’t access, or without Ads API approval.
- Change your X account password or account-wide security settings.
8. Troubleshooting
For general MCP issues, see /mcp/integrations.
9. Frequently asked questions
Do I need Ads API access? Yes. The X Ads API requires your account to be approved for API access. Without it, the connector can authorize but calls to manage campaigns will be denied. Why do I need a funding instrument ID? X ties spending to a funding instrument (your payment source). Creating a campaign requires a validfunding_instrument_id on the ad account.
Why are my budgets so large?
Budgets use local micro amounts — the account currency multiplied by 1,000,000. A $25.00 budget is 25000000. This is how the X Ads API represents money.
Is my ad data stored by UnleashX?
No. UnleashX reads and writes through the X Ads API live per request; it doesn’t keep a copy of your campaigns.
10. References
- X Ads API documentation: https://developer.x.com/en/docs/x-ads-api
- Campaign management: https://developer.x.com/en/docs/x-ads-api/campaign-management/api-reference/campaigns
- X Ads API access & apps: https://developer.x.com/en/docs/x-ads-api/getting-started
- X connected apps / revoke access: https://x.com/settings/connected_apps