---
title: "Integrations - Twitterads"
url: "https://docs.unified.to/integrations/twitterads"
description: "Unified.to documentation"
---
##  Integration: X Ads (Twitter Ads) ![X Ads (Twitter Ads)](https://api.unified.to/docs/images/twitter.png)

[Back to integrations](/integrations)

#### Overview

Company website:

<https://ads.x.com>

Integration launch date:

December 31, 2025

API Categories:

[Advertising](/ads/overview)[Passthrough](/passthrough/overview)

API Authorization:

 OAuth2 flow App-Only Token

Data-regions:

 Production Sandbox

#### ADS ORGANIZATION

End-API object:

 account

Unified API Methods:

[List](/ads/organization/List%5Fall%5Forganizations)

List options:

limitoffset

Readable fields:

[created\_at](/ads/organization/model)[currency](/ads/organization/model)[id](/ads/organization/model)[name](/ads/organization/model)[timezone](/ads/organization/model)[updated\_at](/ads/organization/model)

Writable fields:

[\-none-](/ads/organization/model)

#### ADS CAMPAIGN

End-API object:

 campaign

Unified API Methods:

[Remove](/ads/campaign/Remove%5Fa%5Fcampaign)[List](/ads/campaign/List%5Fall%5Fcampaigns)[Get](/ads/campaign/Retrieve%5Fa%5Fcampaign)[Create](/ads/campaign/Create%5Fa%5Fcampaign)[Update](/ads/campaign/Update%5Fa%5Fcampaign)

List options:

limitoffsetorg\_id

Readable fields:

[budget\_amount](/ads/campaign/model)[budget\_period](/ads/campaign/model)[created\_at](/ads/campaign/model)[currency](/ads/campaign/model)[end\_at](/ads/campaign/model)[id](/ads/campaign/model)[name](/ads/campaign/model)[organization\_id](/ads/campaign/model)[start\_at](/ads/campaign/model)[status](/ads/campaign/model)[updated\_at](/ads/campaign/model)

Writable fields:

[name](/ads/campaign/model)[organization\_id](/ads/campaign/model)[budget\_amount](/ads/campaign/model)[budget\_period](/ads/campaign/model)[campaign\_budget\_identifier](/ads/campaign/model)[end\_at](/ads/campaign/model)[start\_at](/ads/campaign/model)[status](/ads/campaign/model)

 required fields 

#### ADS GROUP

End-API object:

 line\_item

Unified API Methods:

[Create](/ads/group/Create%5Fa%5Fgroup)[Get](/ads/group/Retrieve%5Fa%5Fgroup)[Remove](/ads/group/Remove%5Fa%5Fgroup)[List](/ads/group/List%5Fall%5Fgroups)[Update](/ads/group/Update%5Fa%5Fgroup)

List options:

campaign\_idlimitoffsetorg\_id

Readable fields:

[bid\_amount](/ads/group/model)[billing\_event](/ads/group/model)[budget\_amount](/ads/group/model)[budget\_period](/ads/group/model)[campaign\_id](/ads/group/model)[created\_at](/ads/group/model)[end\_at](/ads/group/model)[id](/ads/group/model)[name](/ads/group/model)[optimization\_goal](/ads/group/model)[organization\_id](/ads/group/model)[start\_at](/ads/group/model)[status](/ads/group/model)[targeting](/ads/group/model)[type](/ads/group/model)[updated\_at](/ads/group/model)

Writable fields:

[campaign\_id](/ads/group/model)[name](/ads/group/model)[organization\_id](/ads/group/model)[bid\_amount](/ads/group/model)[billing\_event](/ads/group/model)[budget\_amount](/ads/group/model)[budget\_period](/ads/group/model)[end\_at](/ads/group/model)[optimization\_goal](/ads/group/model)[start\_at](/ads/group/model)[status](/ads/group/model)[targeting](/ads/group/model)[type](/ads/group/model)

 required fields 

#### ADS AD

End-API object:

 promoted\_tweet

Unified API Methods:

[Remove](/ads/ad/Remove%5Fan%5Fad)[List](/ads/ad/List%5Fall%5Fads)[Get](/ads/ad/Retrieve%5Fan%5Fad)[Create](/ads/ad/Create%5Fan%5Fad)[Update](/ads/ad/Update%5Fan%5Fad)

List options:

group\_idlimitoffsetorg\_id

Readable fields:

[ad\_copy](/ads/ad/model)[ad\_type](/ads/ad/model)[campaign\_id](/ads/ad/model)[created\_at](/ads/ad/model)[description](/ads/ad/model)[final\_url](/ads/ad/model)[group\_id](/ads/ad/model)[headline](/ads/ad/model)[id](/ads/ad/model)[name](/ads/ad/model)[organization\_id](/ads/ad/model)[promoted](/ads/ad/model)[status](/ads/ad/model)[updated\_at](/ads/ad/model)

Writable fields:

[group\_id](/ads/ad/model)[name](/ads/ad/model)[organization\_id](/ads/ad/model)[promoted](/ads/ad/model)[status](/ads/ad/model)

 required fields 

#### ADS CREATIVE

End-API object:

 promoted\_tweet

Unified API Methods:

[Remove](/ads/creative/Remove%5Fa%5Fcreative)[List](/ads/creative/List%5Fall%5Fcreatives)[Get](/ads/creative/Retrieve%5Fa%5Fcreative)[Create](/ads/creative/Create%5Fa%5Fcreative)[Update](/ads/creative/Update%5Fa%5Fcreative)

List options:

group\_idlimitoffsetorg\_id

Readable fields:

[body](/ads/creative/model)[campaign\_id](/ads/creative/model)[creative\_type](/ads/creative/model)[group\_id](/ads/creative/model)[id](/ads/creative/model)[link\_url](/ads/creative/model)[name](/ads/creative/model)[organization\_id](/ads/creative/model)[promoted](/ads/creative/model)[status](/ads/creative/model)[title](/ads/creative/model)

Writable fields:

[group\_id](/ads/creative/model)[name](/ads/creative/model)[organization\_id](/ads/creative/model)[asset\_urls](/ads/creative/model)[body](/ads/creative/model)[cta](/ads/creative/model)[link\_url](/ads/creative/model)[promoted](/ads/creative/model)[status](/ads/creative/model)[title](/ads/creative/model)

 required fields 

#### ADS REPORT

End-API object:

 analytics

Unified API Methods:

[List](/ads/report/List%5Fall%5Freports)

List options:

ad\_idcampaign\_idend\_ltgroup\_idlimitoffsetorg\_idstart\_gte

Readable fields:

[currency](/ads/report/model)[end\_at](/ads/report/model)[id](/ads/report/model)[metrics](/ads/report/model)[organization\_id](/ads/report/model)[start\_at](/ads/report/model)

Writable fields:

[\-none-](/ads/report/model)

#### ADS TARGET

Unified API Methods:

[List](/ads/target/List%5Fall%5Ftargets)

List options:

querytypeorg\_id

 required filter 

Readable fields:

[id](/ads/target/model)[name](/ads/target/model)[type](/ads/target/model)

Writable fields:

[\-none-](/ads/target/model)

#### ADS PROMOTED

End-API object:

 tweet

Unified API Methods:

[List](/ads/promoted/List%5Fall%5Fpromoteds)

List options:

limitoffset

Readable fields:

[id](/ads/promoted/model)[name](/ads/promoted/model)[type](/ads/promoted/model)

Writable fields:

[\-none-](/ads/promoted/model)

#### PASSTHROUGH

Unified API Methods:

[POST](/passthrough/overview)[GET](/passthrough/overview)[PUT](/passthrough/overview)[DELETE](/passthrough/overview)

List options:

\-none-

Readable fields:

[\-none-](/passthrough/undefined/model)

Writable fields:

[\-none-](/passthrough/undefined/model)