Facebook Marketing API connector icon

Facebook Marketing API Connector

Embed Facebook ad management and reporting into your SaaS. Create, update and report on campaigns, audiences, creatives and leads to power customer-facing automations and synchronized marketing workflows.

Build with this Connector Talk to an integration expert
01

Ship integrations faster

Prebuilt actions reduce engineering work and accelerate time to value.

02

Governed MCP tools

Expose safe, versioned ad workflows to customers with centralized control.

03

Scale multitenant workflows

Orchestrate ad updates across many accounts and tenants reliably.

04

Embedded experience

Deliver customer-facing workflows natively inside your SaaS product.

CONNECTOR OVERVIEW

Overview

The Facebook Marketing API lets your product orchestrate ad campaigns, audience segments, creatives and insights programmatically. With Cyclr you can embed those capabilities in your application, expose governed MCP tools to customers and build multitenant automations that sync user data into ads and pull performance metrics for reporting. Production use requires appropriate app permissions and access tokens. (ptacts.uspto.gov)

PRODUCT USE CASES

Use-case introduction

Use the connector to automate campaign creation, audience sync, lead ingestion and scheduled reporting across many customer accounts, and publish those automations inside your product as managed MCP tools.

Automate campaign creation and updates

Create or update campaigns and ad sets when customers trigger product events or reach lifecycle milestones.

Ingest and route Facebook leads

Receive lead IDs via webhooks, fetch lead details and push leads into customer CRM or workflows.

Consolidated ad performance dashboards

Pull insights across multiple ad accounts for scheduled reports and in-app performance views per tenant.

ORCHESTRATION

How Facebook Marketing API works with Cyclr

Cyclr sits between your SaaS product and Facebook Marketing API to handle authentication, govern access and orchestrate every API call per customer, at scale.

  1. 1

    Your SaaS product

    Your app requests an action for a specific customer.

  2. 2

    Cyclr orchestration

    Cyclr authenticates, applies policies and routes the request.

  3. 3

    Facebook Marketing API

    Facebook Marketing API processes the request and returns a response to your app.

Customer-specific authentication · Governed data movement · Centralized visibility and audit

CONNECTOR COVERAGE

Available connector capabilities

Explore Facebook Marketing API methods you can orchestrate through Cyclr.

Ads6

List Ads

Action

Gets a list of ads for the ad Account.

Create Ad

Action

Create an ad.

Get Ad

Action

Get an ad specified by ID.

Update Ad

Action

Update an ad.

List Ads By Ad Set

Action

Gets a list of ads for the specified ad set.

Reach Estimate

Action

Gets the estimated reach for an ad specified by ID.

Pages1

List My Pages

Action

Gets the Facebook pages to which you have access.

Ad Accounts2

List My Ad Accounts

Action

Gets the advertising accounts to which you have access.

List My Permissions

Action

Gets all permissions of the current account.

Ad Creatives3

Update Ad Creative

Action

Update an ad creative.

Get Ad Creative

Action

Gets an ad creative by its ID.

Create Ad Creative

Action

Create an ad creative.

Campaigns5

List Campaigns

Action

Gets the ad campaigns of an ad account.

Create Campaign

Action

Create a campaign.

Update Campaign

Action

Update a campaign.

Delete Campaign

Action

Delete a Campaign.

List Campaign Insights

Action

Gets a campaign's statistics.

Ad Sets3

List Ad Sets By Campaign

Action

Returns ad sets for the specified campaign.

Update Ad Set

Action

Updates an ad Set.

Create Ad Set

Action

Creates an ad set.

Ad Leads3

List Leads By Ad ID and Time Created

Action

Returns leads associated with the specified ad, created since the provided datetime.

List New Leads By Ad ID

Action

Returns leads associated with the specified ad, created since the last run.

List Leads By Ad ID

Action

Returns leads associated with the specified ad.

Forms2

List Forms

Action

List forms for the specified account ID

Get Form

Action

Get a form specified by ID.

Webhooks2

Generic Webhook

Webhook

Triggered when there is a change to a page.

Leadgen Webhook

Webhook

Triggered when there is a change to a page's lead ads.

Offline Conversions1

List Offline Conversion Data Sets

Action

List of Offline Conversion Data Sets available for this Ad Account.

Form Leads3

List Leads By Form

Action

Returns leads associated with the specified form.

List New Leads By Form

Action

Returns leads associated with the specified form created since the last successful run.

List Leads By Form and Time Created

Action

Returns leads associated with the specified form created since the provided datetime.

Posts1

List Posts

Action

Gets the posts that were published by a page.

Leads1

Get Lead By ID

Action

Get a lead specified by ID.

TECHNICAL DETAILS

Facebook Marketing API integration and API details

Review the sourced authentication and API behaviour used when configuring customer-facing Facebook Marketing API integrations in Cyclr.

API and authentication

API host
https://graph.facebook.com
Authentication
OAuth 2.0 access tokens (Graph API)
Credentials

App ID, App Secret, Access Token, Ad Account ID, optional System User token.

Method categories

Campaigns, Ad Sets, Ads, Creatives, Insights, Audiences, Leads

View vendor API documentation →

Pagination and rate limits

Pagination

Results use Graph API cursor paging. Use the paging object plus limit and after/before cursors to iterate pages. (socialscience.one)

Rate limits

Marketing endpoints use business and app-scoped rate limits; requests may be throttled and return limit headers or errors. Plan for retries and backoff. (archive.md)

IMPLEMENTATION

Authentication at a glance

Requires Graph API access tokens (user, page, system or app tokens). App secret proof recommended for server calls. App review often required for marketing permissions. (learn.microsoft.com)

Authentication method
OAuth 2.0 access tokens (Graph API)
Credential required

App ID, App Secret, Access Token, Ad Account ID, optional System User token.

Before you begin:

App review and approved marketing permissions are commonly required for production access. (ptacts.uspto.gov)

View setup guide

COMMON QUESTIONS

Frequently asked questions

It provides actions for creating and managing campaigns, audiences, ads and creatives, fetching insights and ingesting lead data so you can embed ad workflows in your app.

You authenticate with Graph API access tokens. Apps commonly use user, page, app or business system user tokens and should use appsecret_proof for server requests.

Yes. Production access to many marketing endpoints requires approved permissions through app review and correct roles on customer Business Manager accounts.

Yes. Cyclr lets you package connector actions into governed MCP tools that you can publish and manage for customers.

KEEP EXPLORING

Related resources and connectors

Documentation

What is iPaaS?

Read more →Product

How to develop an API – Best Practices to Follow from Cyclr Developers

Read more →Product

MCP PaaS

Read more →Related connector

Facebook Audiences

Related Social Media connector for customer-facing integration workflows.

Related connector

Facebook Conversions

Related Social Media connector for customer-facing integration workflows.

Related connector

Facebook Insights

Related Social Media connector for customer-facing integration workflows.

Let Cyclr handle the integrations.

You focus on building the product your customers love.

Start building for free Get a demo