Nexra
All connectors
Implemented
Marketing & advertising
Meta Ads logo

Meta Ads

Read Meta campaigns, ad sets, ads, insights, custom audiences and lead form leads; create paused campaigns, ad sets and ads; change status and budgets explicitly; send Conversions API events.

Report Facebook and Instagram ad performance, route lead ads into CRMs and send server-side conversions for measurement and optimisation.

Build a flow with Meta AdsProvider API documentation

Source actions

11

Destination actions

7

Data types

9

Validation status

Implemented · fixture tested.

Implementation is checked against provider-shaped fixtures for every action, authentication failures, rate limits, pagination and duplicate safety. Provider sandbox and authorised account validation are recorded separately when credential-backed runs are completed.

What you can map

ad accounts
  • Get ad account
    Source

    The configured ad account's name, status, currency, time zone and spend.

    ad_accounts.get
ad sets
  • Create paused ad set
    Destination
    Not retried automatically
    Approval before production

    Creates an ad set in PAUSED status with an explicit budget and targeting.

    ad_sets.create
  • Get ad set
    Source

    An ad set by ID.

    ad_sets.get
  • List ad sets
    Source
    Incremental

    Ad sets with budgets, optimisation goal, billing event and targeting.

    ad_sets.list
  • Change ad set status or budget
    Destination
    Provider duplicate protection
    Approval before production

    Activates, pauses or renames an ad set, or sets an explicit budget, bid or end time.

    ad_sets.update
ads
  • Create paused ad
    Destination
    Not retried automatically
    Approval before production

    Creates an ad in PAUSED status from an existing creative.

    ads.create
  • Get ad
    Source

    An ad by ID.

    ads.get
  • List ads
    Source
    Incremental

    Ads with status and creative.

    ads.list
  • Change ad status
    Destination
    Provider duplicate protection
    Approval before production

    Activates, pauses or renames an ad.

    ads.update
campaigns
  • Create paused campaign
    Destination
    Not retried automatically
    Approval before production

    Creates a campaign in PAUSED status; it does not deliver until activated.

    campaigns.create
  • Get campaign
    Source

    A campaign by ID.

    campaigns.get
  • List campaigns
    Source

    Campaigns in the ad account with objective, status and budgets.

    campaigns.list
  • Change campaign status or budget
    Destination
    Provider duplicate protection
    Approval before production

    Activates, pauses or renames a campaign, or sets an explicit budget or spend cap.

    campaigns.update
conversion events
  • Send Conversions API event
    Destination
    Provider duplicate protection
    Approval before production

    Sends one server event to the configured pixel (dataset); Meta deduplicates on eventId and event name.

    conversion_events.send
custom audiences
  • List custom audiences
    Source

    Custom audiences with subtype, size bounds and delivery status (read-only).

    custom_audiences.list
insights
  • Get ad insights
    Source

    Performance metrics for the ad account at account, campaign, ad set or ad level over a bounded period.

    insights.list
lead forms
  • List lead forms
    Source

    Lead generation forms on a Page.

    lead_forms.list
leads
  • List leads
    Source
    Incremental

    Lead ads submissions for a form, with answers and ad attribution.

    leads.list

Authentication

System user access token (bearer)

Plans and access

Marketing API access through a Meta app with ads_read/ads_management (Standard Access for production volumes). Use a system user token assigned to the ad account (and Page for lead ads) with ads_read, ads_management, leads_retrieval and pages permissions.

Test environment

Sandbox ad accounts are available from the app's Marketing API tools.

Rate limits

Business Use Case rate limits per ad account, reported in X-Business-Use-Case-Usage headers; error codes 17, 80000-80014 indicate throttling.

Pagination

Graph API cursor paging with limit and after while paging.next is present.

Provider events

Page leadgen webhooks for new lead ads submissions. Nexra event triggers are not yet available; flows run on demand or on a schedule.

Before you build a flow

  • Pinned to Graph API v26.0.
  • Campaigns, ad sets and ads are always created PAUSED; activation and budget changes need explicit inputs.
  • Deleting or archiving campaigns, ad sets and ads is not implemented.
  • The access token is sent in the Authorization header; appsecret_proof (sent as a parameter) is not supported, so 'Require app secret' must be off.
  • Conversions API events are deduplicated by Meta on event_id and event_name within 48 hours; send a stable eventId.
  • Insights use bounded date presets or explicit ranges; maximum and data_maximum presets are not offered.
  • Lead forms need a token with access to the Page; Meta may require a Page access token for leadgen_forms.

Developer reference

  1. Create the Meta credentials described above with the narrowest permissions your flows need.
  2. In Nexra, open Connect, then Connections, then New connection, choose Meta Ads, enter its settings and credentials, and tick only the write actions you need. Connection guide
  3. Test the connection, then use its actions as flow sources and destinations. Flow guide
Meta docsAPI referenceMeta docsAuthenticationMeta docsRate limitsMeta docsWebhooks

Machine-readable detail: GET /api/public/connect/connectors/meta-ads and the Connections API.