Tools

Get Account Info

Read the authenticated actor and exact ad account identity, currency, approval state and optional funding instruments. Use list_ad_accounts to discover account IDs.

List Ad Groups

Retrieve one page of ad groups for a selected ad account, optionally filtered by campaign. Returns current configured state, relationships and provider values. Follow nextUrl with the same selectors to continue.

Manage Campaign

Create or update a Standard campaign. Creation requires an explicit status; ACTIVE may enable advertising spend. ARCHIVED/DELETED are retained states, not history erasure. Current API constraints and account ownership are checked before writing.

Manage Audience Users

Submit hashed user rows for a selected customer-list audience. A 204 response acknowledges the request; it does not supply a processed-user count or prove completed matching.

Delete Custom Audience

Delete an exact custom audience after verifying its account association. The provider’s 204 acknowledgment does not assert erasure of historic advertising records.

List Custom Audiences

Retrieve one page of audiences for a selected ad account. Returns current provider state, size ranges and relationships. Follow nextUrl with the same account to continue.

Manage Custom Audience

Create customer-list, website or engagement audiences using documented configuration. Existing audiences are readable, but metadata updates, description fields and lookalike creation are unsupported by this API.

List Ad Accounts

Discover authenticated actor and businesses, then supply businessId to query that business’s ad accounts. Returns one page; no account is selected automatically.

List Ads

Retrieve one page of ads for a selected ad account, optionally filtered by ad group. Returns current configured state, relationships and provider values. Follow nextUrl with the same selectors to continue.

List Pixels

Discover one page of Pixels available to a selected advertising account for campaign measurement and conversion-event targeting.

Manage Ad

Create or update a Standard ad. Creation requires an explicit status; ACTIVE may enable advertising spend. ARCHIVED/DELETED are retained states, not history erasure. Current API constraints and account ownership are checked before writing.

Get Resource

Read one exact campaign, ad group, ad or custom audience and verify its account association. Includes provider state and relationships for independent write readback.

Manage Ad Group

Create or update a Standard ad group. Creation requires an explicit status; ACTIVE may enable advertising spend. ARCHIVED/DELETED are retained states, not history erasure. Current API constraints and account ownership are checked before writing.

Get Performance Report

Retrieve one page of campaign performance data with documented metrics and dimensions. YYYY-MM-DD dates become UTC midnight boundaries without extending endDate. Monetary metrics retain their provider units.

Send Conversion Events

Submit irreversible conversion events using deliberately selected CAPI v2 or v3. Preserves prehashed match keys and base-currency value. An HTTP acknowledgment is distinct from attribution or deduplication completion.

List Campaigns

Retrieve one page of campaigns for a selected ad account. Returns current configured state, relationships and provider values. Follow nextUrl to continue; a campaign status filter applies only to the returned page.

List Posts

Discover the profiles linked to an ad account, then list one page of a profile’s posts. Use a returned postId as the creative when creating an ad with manage_ad.

List Targeting Options

Find targetable communities, interests or geolocations for ad-group targeting. Communities are searched by name or topic and paginated; interests and geolocations return one filtered list.