Skip to content

NEWUnify Agents (MCP): governed AI access to finance data. Early access.See Unify Agents

MA

ADS INTEGRATION

Meta Ads integration with the Unify Ads API

Planned: Meta Ads ad accounts, campaigns and ad sets, plus 3 more objects, on one data model.

RoadmapOAuth 2.0 · Sandbox yes

GET /v1/product-data/ad-accounts?platform=meta-ads&limit=1

API design preview

Request

curl "https://api.unifyint.com/v1/product-data/ad-accounts?platform=meta-ads&limit=1" \
  -H "Authorization: Bearer $UNIFY_API_KEY"

200 OK · API design preview

{
  "data": [
    {
      "id": "ad_01EXAMPLE",
      "object": "ad_account",
      "remote_id": "example-1001",
      "name": "Accounts Receivable",
      "type": "asset",
      "currency": "USD",
      "updated_at": "2026-10-28T14:02:11Z",
      "raw": { "...": "original Meta Ads record, unchanged" }
    }
  ],
  "next_cursor": null
}

API design preview. Field names may change before general availability.

On our roadmap. Request it to move it up.

Request Meta Ads

About the Meta Ads integration

Meta Ads runs advertising across Facebook, Instagram, Messenger and the Audience Network. The Unify Ads API reads its ad accounts, campaigns, ad sets, ads and daily insights for spend, reach and conversions.

The Meta Marketing API uses OAuth through Facebook Login with ads_read permissions and app review, and the Insights API for metrics. The Unify Ads API maps ad accounts, campaigns, ad sets, ads, conversions and daily insights to the Unify Graph.

Status
Roadmap
Category
Ads
Auth
OAuth 2.0
Sandbox
Available
Webhooks
No (polling)
Bank feeds
No
Regions
Global

Supported objects

Read and write status for each Meta Ads object in the Unify Ads API. Write appears only where write-back is confirmed.

  • Ad Accounts

    Read on roadmap
  • Campaigns

    Read on roadmapWrite on roadmap
  • Ad Sets

    Read on roadmap
  • Ads

    Read on roadmap
  • Insights

    Read on roadmap
  • Conversions

    Read on roadmap

Why build Meta Ads on Unify Int

  • One data model

    Meta Ads records arrive in the same Unify Graph shape as every other platform in the category, with the original record kept in raw.

  • Unify Connect

    A white-label flow for your customers to authorize Meta Ads. Tokens are stored and refreshed for you.

  • Custom fields and passthrough

    Map Meta Ads custom fields per connection, and call any endpoint the model does not cover through passthrough requests.

  • Unify Monitor

    Request logs, sync health and alerts for every Meta Ads connection, so support can see what happened.

Meta Ads integration questions

Does Unify Int support Meta Ads campaigns and ads?
Meta Ads is on the Unify Int roadmap. The planned scope covers reading ad accounts, campaigns, ad sets, ads, insights and conversions, with write-back for campaigns to follow. Request it to move it up, or ask the Technology Center about a custom build.
How do customers connect their Meta Ads account?
Your customer signs in with Facebook (Meta) in Unify Connect and grants access to the ad accounts you need.
Is there a Meta Ads sandbox for testing?
Yes. Meta provides sandbox ad accounts for Marketing API development.
How often does Meta Ads data sync?
Meta Ads does not emit webhooks for most objects, so Unify Sync polls incrementally on the schedule you set per object, typically every 15 minutes to daily, and sends you signed webhooks when records change.
Can I access Meta Ads custom fields?
Custom conversions and action breakdowns are kept on insight records; other fields are available through passthrough.

Get started

Connect once. Build everything else on top.

Request sandbox access, or book 30 minutes with an engineer to map your integrations.

Free sandbox access. No credit card. Reply within one business day.