--- title: "Integrations - Metaads" url: "https://docs.unified.to/integrations/metaads" description: "Unified.to documentation" --- ## Integration: Meta Ads ![Meta Ads](https://api.unified.to/docs/images/metaads.png) [Back to integrations](/integrations) #### Overview Company website: Integration launch date: January 1, 2026 API Categories: [Advertising](/ads/overview)[Passthrough](/passthrough/overview) API Authorization: OAuth2 flow Access Token / Ad Account ID #### ADS ORGANIZATION End-API object: adaccount Unified API Methods: [List](/ads/organization/List%5Fall%5Forganizations)[Get](/ads/organization/Retrieve%5Fan%5Forganization) Webhooks: Virtual List options: limitoffsetupdated\_gte Readable fields: [created\_at](/ads/organization/model)[currency](/ads/organization/model)[id](/ads/organization/model)[name](/ads/organization/model)[status](/ads/organization/model)[timezone](/ads/organization/model) Writable fields: [\-none-](/ads/organization/model) #### ADS CAMPAIGN End-API object: campaign Unified API Methods: [List](/ads/campaign/List%5Fall%5Fcampaigns)[Get](/ads/campaign/Retrieve%5Fa%5Fcampaign)[Create](/ads/campaign/Create%5Fa%5Fcampaign)[Update](/ads/campaign/Update%5Fa%5Fcampaign)[Remove](/ads/campaign/Remove%5Fa%5Fcampaign) Webhooks: Virtual List options: effective\_statusend\_ltgoallimitoffsetorg\_idstart\_gteupdated\_gte Readable fields: [budget\_amount](/ads/campaign/model)[budget\_period](/ads/campaign/model)[category](/ads/campaign/model)[created\_at](/ads/campaign/model)[effective\_status](/ads/campaign/model)[end\_at](/ads/campaign/model)[goal](/ads/campaign/model)[id](/ads/campaign/model)[labels](/ads/campaign/model)[name](/ads/campaign/model)[organization\_id](/ads/campaign/model)[planned\_spend\_amount](/ads/campaign/model)[start\_at](/ads/campaign/model)[status](/ads/campaign/model)[updated\_at](/ads/campaign/model) Writable fields: [budget\_amount](/ads/campaign/model)[budget\_period](/ads/campaign/model)[category](/ads/campaign/model)[end\_at](/ads/campaign/model)[goal](/ads/campaign/model)[name](/ads/campaign/model)[organization\_id](/ads/campaign/model)[planned\_spend\_amount](/ads/campaign/model)[start\_at](/ads/campaign/model)[status](/ads/campaign/model) #### ADS GROUP End-API object: adset Unified API Methods: [List](/ads/group/List%5Fall%5Fgroups)[Get](/ads/group/Retrieve%5Fa%5Fgroup)[Create](/ads/group/Create%5Fa%5Fgroup)[Update](/ads/group/Update%5Fa%5Fgroup)[Remove](/ads/group/Remove%5Fa%5Fgroup) Webhooks: Virtual List options: campaign\_ideffective\_statuslimitoffsetorg\_idupdated\_gte Readable fields: [bid\_strategy](/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)[effective\_status](/ads/group/model)[end\_at](/ads/group/model)[frequency\_cap](/ads/group/model)[id](/ads/group/model)[name](/ads/group/model)[optimization\_goal](/ads/group/model)[organization\_id](/ads/group/model)[promoted](/ads/group/model)[start\_at](/ads/group/model)[status](/ads/group/model)[targeting](/ads/group/model)[updated\_at](/ads/group/model) Writable fields: [campaign\_id](/ads/group/model)[bid\_amount](/ads/group/model)[bid\_strategy](/ads/group/model)[billing\_event](/ads/group/model)[budget\_amount](/ads/group/model)[budget\_period](/ads/group/model)[end\_at](/ads/group/model)[frequency\_cap](/ads/group/model)[name](/ads/group/model)[optimization\_goal](/ads/group/model)[organization\_id](/ads/group/model)[promoted](/ads/group/model)[start\_at](/ads/group/model)[status](/ads/group/model)[targeting](/ads/group/model) required fields #### ADS AD End-API object: ad adgroupad Unified API Methods: [List](/ads/ad/List%5Fall%5Fads)[Get](/ads/ad/Retrieve%5Fan%5Fad)[Create](/ads/ad/Create%5Fan%5Fad)[Update](/ads/ad/Update%5Fan%5Fad)[Remove](/ads/ad/Remove%5Fan%5Fad) Webhooks: Virtual List options: campaign\_idgroup\_idlimitoffsetorg\_idupdated\_gte Readable fields: [ad\_copy](/ads/ad/model)[ad\_type](/ads/ad/model)[campaign\_id](/ads/ad/model)[created\_at](/ads/ad/model)[creative\_asset\_url](/ads/ad/model)[creative\_ids](/ads/ad/model)[cta](/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)[status](/ads/ad/model)[updated\_at](/ads/ad/model) Writable fields: [group\_id](/ads/ad/model)[creative\_ids](/ads/ad/model)[name](/ads/ad/model)[organization\_id](/ads/ad/model)[status](/ads/ad/model) required fields #### ADS CREATIVE End-API object: adcreative Unified API Methods: [List](/ads/creative/List%5Fall%5Fcreatives)[Get](/ads/creative/Retrieve%5Fa%5Fcreative)[Create](/ads/creative/Create%5Fa%5Fcreative)[Update](/ads/creative/Update%5Fa%5Fcreative)[Remove](/ads/creative/Remove%5Fa%5Fcreative) Webhooks: Virtual List options: group\_idlimitoffsetorg\_idupdated\_gte Readable fields: [asset\_urls](/ads/creative/model)[body](/ads/creative/model)[creative\_type](/ads/creative/model)[cta](/ads/creative/model)[external\_creative\_reference](/ads/creative/model)[external\_placement\_reference](/ads/creative/model)[hosting\_source](/ads/creative/model)[id](/ads/creative/model)[labels](/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)[url\_tags](/ads/creative/model) Writable fields: [promoted](/ads/creative/model)[asset\_urls](/ads/creative/model)[body](/ads/creative/model)[creative\_type](/ads/creative/model)[cta](/ads/creative/model)[external\_creative\_reference](/ads/creative/model)[external\_placement\_reference](/ads/creative/model)[link\_url](/ads/creative/model)[name](/ads/creative/model)[organization\_id](/ads/creative/model)[status](/ads/creative/model)[title](/ads/creative/model)[url\_tags](/ads/creative/model) required fields #### ADS ASSET End-API object: adimage advideo Unified API Methods: [List](/ads/asset/List%5Fall%5Fassets)[Get](/ads/asset/Retrieve%5Fan%5Fasset)[Create](/ads/asset/Create%5Fan%5Fasset)[Remove](/ads/asset/Remove%5Fan%5Fasset) List options: limitoffsetorg\_idtype Readable fields: [created\_at](/ads/asset/model)[height](/ads/asset/model)[id](/ads/asset/model)[name](/ads/asset/model)[organization\_id](/ads/asset/model)[type](/ads/asset/model)[url](/ads/asset/model)[width](/ads/asset/model) Writable fields: [content](/ads/asset/model)[name](/ads/asset/model)[organization\_id](/ads/asset/model)[type](/ads/asset/model)[url](/ads/asset/model) #### ADS REPORT End-API object: insights Unified API Methods: [List](/ads/report/List%5Fall%5Freports) Webhooks: Virtual List options: ad\_idcampaign\_iddimensionend\_ltgroup\_idlimitoffsetorg\_idstart\_gtetypeupdated\_gte Readable fields: [end\_at](/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) Webhooks: Virtual List options: limitoffsetorg\_idquerytypeupdated\_gte Readable fields: [audience\_count\_max](/ads/target/model)[audience\_count\_min](/ads/target/model)[id](/ads/target/model)[name](/ads/target/model)[type](/ads/target/model) Writable fields: [\-none-](/ads/target/model) #### ADS PROMOTED Unified API Methods: [List](/ads/promoted/List%5Fall%5Fpromoteds)[Get](/ads/promoted/Retrieve%5Fa%5Fpromoted) List options: org\_idquerytype 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)