Integrations - Metaads

AI agent? Read this page as Markdown at /integrations/metaads.md — append .md to any docs URL, or start from /llms.txt. Agent Skill for this page: /skills/meta-ads-oauth-app/SKILL.md.

Integration: Meta Ads
Back to integrations

Overview

Company website:

https://business.facebook.com

Integration launch date:

January 1, 2026

API Categories:

Advertising Passthrough

API Authorization:

OAuth2 flow Access Token / Ad Account ID

ADS ORGANIZATION

End-API object:

adaccount

Unified API Methods:

List Get

Webhooks:

Virtual

List options:

limit offset updated_gte

Readable fields:

created_at currency id name status timezone

Writable fields:

-none-

ADS CAMPAIGN

End-API object:

campaign

Unified API Methods:

List Get Create Update Remove

Webhooks:

Virtual

List options:

effective_status end_lt goal limit offset org_id start_gte updated_gte

Readable fields:

budget_amount budget_period category created_at effective_status end_at goal id labels name organization_id planned_spend_amount start_at status updated_at

Writable fields:

budget_amount budget_period category end_at goal name organization_id planned_spend_amount start_at status

ADS GROUP

End-API object:

adset

Unified API Methods:

List Get Create Update Remove

Webhooks:

Virtual

List options:

campaign_id effective_status limit offset org_id updated_gte

Readable fields:

bid_strategy billing_event budget_amount budget_period campaign_id created_at effective_status end_at frequency_cap id name optimization_goal organization_id promoted start_at status targeting updated_at

Writable fields:

campaign_id bid_amount bid_strategy billing_event budget_amount budget_period end_at frequency_cap name optimization_goal organization_id promoted start_at status targeting

required fields

ADS AD

End-API object:

ad adgroupad

Unified API Methods:

List Get Create Update Remove

Webhooks:

Virtual

List options:

campaign_id group_id limit offset org_id updated_gte

Readable fields:

ad_copy ad_type campaign_id created_at creative_asset_url creative_ids cta description final_url group_id headline id name organization_id status updated_at

Writable fields:

group_id creative_ids name organization_id status

required fields

ADS CREATIVE

End-API object:

adcreative

Unified API Methods:

List Get Create Update Remove

Webhooks:

Virtual

List options:

group_id limit offset org_id updated_gte

Readable fields:

asset_urls body creative_type cta external_creative_reference external_placement_reference hosting_source id labels link_url name organization_id promoted status title url_tags

Writable fields:

promoted asset_urls body creative_type cta external_creative_reference external_placement_reference link_url name organization_id status title url_tags

required fields

ADS ASSET

End-API object:

adimage advideo

Unified API Methods:

List Get Create Remove

List options:

limit offset org_id type

Readable fields:

created_at height id name organization_id type url width

Writable fields:

content name organization_id type url

ADS REPORT

End-API object:

insights

Unified API Methods:

List

Webhooks:

Virtual

List options:

ad_id campaign_id dimension end_lt group_id limit offset org_id start_gte type updated_gte

Readable fields:

end_at metrics organization_id start_at

Writable fields:

-none-

ADS TARGET

Unified API Methods:

List

Webhooks:

Virtual

List options:

limit offset org_id query type updated_gte

Readable fields:

audience_count_max audience_count_min id name type

Writable fields:

-none-

ADS PROMOTED

Unified API Methods:

List options:

Readable fields:

Writable fields:

PASSTHROUGH

Unified API Methods:

List options:

Readable fields:

Writable fields:

Are we missing anything? Let us know

Was this page helpful?

Integration: Meta Ads Back to integrations

Overview

ADS ORGANIZATION

ADS CAMPAIGN

ADS GROUP

ADS AD

ADS CREATIVE

ADS ASSET

ADS REPORT

ADS TARGET

ADS PROMOTED

PASSTHROUGH

Integration: Meta Ads
Back to integrations