Integrations - Twitterads - Unified.to

Unified

Integration: X Ads (Twitter Ads)
Back to integrations

Overview

Company website:

https://ads.x.com

Integration launch date:

December 31, 2025

API Categories:

Advertising Passthrough

API Authorization:

OAuth2 flow

ADS ORGANIZATION

End-API object:

account

Unified API Methods:

List options:

Readable fields:

created_at currency id name timezone updated_at

Writable fields:

ADS CAMPAIGN

End-API object:

campaign

Unified API Methods:

Remove List Get Create Update

List options:

limit offset org_id

Readable fields:

budget_amount budget_period created_at currency end_at id name organization_id start_at status updated_at

Writable fields:

name organization_id budget_amount budget_period campaign_budget_identifier end_at start_at status

required fields

ADS GROUP

End-API object:

line_item

Unified API Methods:

Create Get Remove List Update

List options:

campaign_id limit offset org_id

Readable fields:

bid_amount billing_event budget_amount budget_period campaign_id created_at end_at id name optimization_goal organization_id start_at status targeting type updated_at

Writable fields:

campaign_id name organization_id bid_amount billing_event budget_amount budget_period end_at optimization_goal start_at status targeting type

required fields

ADS AD

End-API object:

promoted_tweet

Unified API Methods:

Remove List Get Create Update

List options:

group_id limit offset org_id

Readable fields:

ad_copy ad_type campaign_id created_at description final_url group_id headline id name organization_id promoted status updated_at

Writable fields:

group_id name organization_id promoted status

required fields

ADS CREATIVE

End-API object:

promoted_tweet

Unified API Methods:

Remove List Get Create Update

List options:

group_id limit offset org_id

Readable fields:

body campaign_id creative_type group_id id link_url name organization_id promoted status title

Writable fields:

group_id name organization_id asset_urls body cta link_url promoted status title

required fields

ADS REPORT

End-API object:

analytics

Unified API Methods:

List options:

ad_id campaign_id end_lt group_id limit offset org_id start_gte

Readable fields:

currency end_at id metrics organization_id start_at

Writable fields:

ADS TARGET

Unified API Methods:

List options:

query type org_id

required filter

Readable fields:

id name type value

Writable fields:

ADS PROMOTED

End-API object:

tweet

Unified API Methods:

List options:

Readable fields:

Writable fields:

PASSTHROUGH

Unified API Methods:

POST GET PUT DELETE

List options:

Readable fields:

Writable fields:

Are we missing anything? Let us know

Was this page helpful?