Meta Ads integration

Facebook/Instagram ads: campaigns, ad sets, ads, insights, audiences, creatives

Help CentreConnectors

Overview

Meta Ads (Facebook + Instagram ads) is the dominant social ad platform. The Automize Meta Ads connector covers campaigns, ad sets, ads, insights, audiences, creatives.

  • Regions: Global.
  • Plans: Pay-per-impression/click.

Setting up the connection

Auth type: OAuth 2.0 (Authorization Code).

  1. Meta Developers → create app → add Marketing API product.
  2. OAuth scope: ads_management.
  3. In Automize → Settings → Connectors → Meta Ads. Paste credentials + ad account ID.

Find your credentials at https://developers.facebook.com/.


Rate limits

Per-app + per-account.


Data model

Ads hierarchy:

    Ad Account ─── Campaigns ─── Ad Sets ─── Ads
                                              ├─ Creatives
                                              └─ Insights (metrics)
                ── Audiences (custom + lookalike)

Available operations

10 operations available. Click any row to jump to its detail.

OperationCategoryWhat it does
Create AdGeneralCreate a new ad
Create Ad SetGeneralCreate a new ad set
Create CampaignGeneralCreate a new ad campaign
Get Ad AccountGeneralGet ad account details
Get Campaign InsightsGeneralGet performance insights for a campaign
Get Account InsightsGeneralGet performance insights for an ad account
List Ad AccountsGeneralList ad accounts for the user
List AdsGeneralList ads for an ad account
List Ad SetsGeneralList ad sets for an ad account
List CampaignsGeneralList campaigns for an ad account

Operations

Create Ad

Create a new ad

ParameterRequiredTypeDescription
Name nameYestext
Adset Id adset_idYestext
Creative creativeYestext
Status statusYestext
Account Id account_idYestext

Create Ad Set

Create a new ad set

ParameterRequiredTypeDescription
Name nameYestext
Campaign Id campaign_idYestext
Daily Budget daily_budgetYestext
Targeting targetingYestext
Billing Event billing_eventYestext
Optimization Goal optimization_goalYestext
Account Id account_idYestext

Create Campaign

Create a new ad campaign

ParameterRequiredTypeDescription
Name nameYestext
Objective objectiveYestext
Status statusYestext
Special Ad Categories special_ad_categoriesYestext
Account Id account_idYestext

Tips

  • objective (OUTCOME_TRAFFIC, OUTCOME_LEADS, etc.) + budget.

Get Ad Account

Get ad account details

ParameterRequiredTypeDescription
Account Id account_idYestext

Get Campaign Insights

Get performance insights for a campaign

ParameterRequiredTypeDescription
Campaign Id campaign_idYestext

Get Account Insights

Get performance insights for an ad account

ParameterRequiredTypeDescription
Account Id account_idYestext

Tips

  • Metrics: impressions, clicks, ctr, cpc, conversions, spend. Breakdown by date/age/gender/placement.

List Ad Accounts

List ad accounts for the user

No input parameters.


List Ads

List ads for an ad account

ParameterRequiredTypeDescription
Account Id account_idYestext

List Ad Sets

List ad sets for an ad account

ParameterRequiredTypeDescription
Account Id account_idYestext

List Campaigns

List campaigns for an ad account

ParameterRequiredTypeDescription
Account Id account_idYestext

Tips

  • Filter by status, objective.

FAQ

iOS 14+ tracking?
Apple's ATT reduced signal. Use Conversions API for server-side events + Aggregated Event Measurement.

Related connectors

See it working on your own data

Everything documented here ships with the platform – try the document tools free, or go live in 7 days.