Overview
X (Twitter) Ads – campaigns, line items, creatives, analytics, audiences, promoted tweets. The Automize Twitter Ads connector covers these.
- Regions: Global.
- Plans: Pay-per-engagement.
Setting up the connection
Auth type: OAuth 2.0 (Authorization Code).
- Twitter Developer Portal → Ads API access (requires application + approval).
- OAuth 1.0a credentials.
- In Automize → Settings → Connectors → Twitter Ads. Paste credentials + ads account ID.
Find your credentials at https://developer.twitter.com/.
Rate limits
Per-app + per-account.
Data model
Ads hierarchy:
Account ── Campaigns ── Line Items ── Promoted Tweets
── Audiences (tailored + lookalike)Available operations
8 operations available. Click any row to jump to its detail.
| Operation | Category | What it does |
|---|---|---|
| Create Campaign | General | Create a new campaign |
| Create Line Item | General | Create a new line item |
| Get Account | General | Get ad account details |
| Get Analytics | General | Get ad analytics data |
| List Accounts | General | List ad accounts |
| List Campaigns | General | List campaigns for an account |
| List Line Items | General | List line items for an account |
| List Promoted Tweets | General | List promoted tweets for an account |
Operations
Create Campaign
Create a new campaign
| Parameter | Required | Type | Description |
|---|---|---|---|
Name name | Yes | text | |
Daily Budget Amount Local Micro daily_budget_amount_local_micro | Yes | text | |
Start Time start_time | Yes | text | |
Funding Instrument Id funding_instrument_id | Yes | text | |
Account Id account_id | Yes | text |
Create Line Item
Create a new line item
| Parameter | Required | Type | Description |
|---|---|---|---|
Campaign Id campaign_id | Yes | text | |
Bid Amount Local Micro bid_amount_local_micro | Yes | text | |
Objective objective | Yes | text | |
Placements placements | Yes | text | |
Account Id account_id | Yes | text |
Get Account
Get ad account details
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Id account_id | Yes | text |
Get Analytics
Get ad analytics data
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Id account_id | Yes | text |
Tips
- Async stats job → poll → results URL.
List Accounts
List ad accounts
No input parameters.
List Campaigns
List campaigns for an account
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Id account_id | Yes | text |
Tips
- Filter by status (ACTIVE, PAUSED, COMPLETED).
List Line Items
List line items for an account
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Id account_id | Yes | text |
Tips
- Ad-group equivalent. Per campaign.
List Promoted Tweets
List promoted tweets for an account
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Id account_id | Yes | text |
FAQ
- Access bar?
- Twitter Ads API requires approval – apply via developer portal with business justification.