Facebook Insights connector icon

Facebook Insights Connector

Use the Facebook Insights Connector to surface ad, campaign and ad set performance metrics from Meta’s Marketing API inside your product. Build scheduled reports, on-demand dashboards and per-customer exports so customers see campaign statistics without leaving your app.

Build with this Connector Talk to an integration expert
01

Embed reports natively

Show campaign metrics inside your app without additional UI work

02

Orchestrate async jobs

Run Insights report_run jobs and fetch results reliably

03

Multi-tenant governance

Control per-customer scopes, throttling and which methods are available

04

Embedded experience

Deliver customer-facing workflows natively inside your SaaS product.

CONNECTOR OVERVIEW

What you can integrate and automate

Integrate ad-account, campaign, ad-set and ad-level metrics from Meta’s Insights edge to power reporting, dashboards and exports inside your SaaS product. Cyclr exposes the Insights edge so teams can run async report jobs, paginate results, apply breakdowns and deliver per-tenant CSV or dashboard updates. (community.cyclr.com)

PRODUCT USE CASES

Top use cases for Facebook Insights integrations

Quickly build scheduled reporting, on-demand dashboards and exports that pull ad, campaign and ad set metrics. Publish these workflows into your white-label embedded marketplace and give customers native access to their advertising performance.

In-app per-customer ad performance dashboard

Pull ad, ad set and campaign metrics for each connected ad account to populate product dashboards and charts.

Scheduled CSV exports of Ads Insights

Run async Insights report_run jobs daily, transform results and deliver CSV exports to customers or storage.

Enrich CRM leads with campaign attribution

Join lead records with ads breakdowns and actions to attribute leads to specific campaigns or ads.

ORCHESTRATION

How Facebook Insights works with Cyclr

Cyclr sits between your SaaS product and Facebook Insights 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 Insights

    Facebook Insights 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 Insights methods you can orchestrate through Cyclr.

Campaigns6

List New Campaigns

Action

Retrieves all campaigns created since the last successful cycle run.

List Campaigns

Action

Retrieves all campaigns.

List Updated Campaigns

Action

Retrieves all campaigns updated since the last successful cycle run.

List Campaign Insights

Action

Retrieves the specified campaign's insights.

List New and Updated Campaigns

Action

Retrieves all campaigns created or updated since the last successful cycle run.

List Campaign Insights By Time Range

Action

Retrieves the specified campaign's insights, by time range.

Ad Accounts7

List Ad Accounts

Action

Retrieves all ad accounts.

List Account Insights

Action

Retrieves the specified account's insights.

List Personal Ad Accounts

Action

Retrieves the specified account's personal ad accounts.

List New Ad Accounts

Action

Retrieves all ad accounts created since the last successful cycle run.

List Account Insights By Time Range

Action

Retrieves the specified account's insights, by time range.

List Ad Account Creatives

Action

Retrieves the specified ad account's ad creatives.

List My Accounts

Action

Retrieves all accounts.

Ads10

List New Ads

Action

Retrieves all ads created since the last successful cycle run.

Get Ad Image

Action

Retrieves the specified ad image.

Preview Ad Creative

Action

Preview an Ad Creative.

List Ad Insights

Action

Retrieves the specified ad's insights.

Get Ad

Action

Retrieves the specified ad.

List Ad Set Ads

Action

Retrieves the specified Ad Set Ad's

List Ad Insights By Time Range

Action

Retrieves the specified ad's insights, by time range.

List Ads

Action

Retrieves all ads.

List New and Updated Ads

Action

Retrieves all ads created or updated since the last successful cycle run.

List Updated Ads

Action

Retrieves all ads updated since the last successful cycle run.

Ad Sets4

List Ad Sets

Action

Retrieves all ad sets.

List Updated Ad Sets

Action

Retrieves all ad sets updated since the last successful cycle run.

List New Ad Sets

Action

Retrieves all ad sets created since the last successful cycle run.

List New and Updated Ad Sets

Action

Retrieves all ad sets created or updated since the last successful cycle run.

Ad set2

List Ad Set Insights By Time Range

Action

Retrieves the specified ad set's insights, by time range.

List Ad Set Insights

Action

Retrieves the specified ad set's insights.

TECHNICAL DETAILS

Facebook Insights integration and API details

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

API and authentication

API host
https://graph.facebook.com
Authentication
OAuth 2.0
Credentials

App/Client ID; App/Client Secret; Valid OAuth Redirect URI; OAuth scopes (ads_read, ads_management).

Method categories

Get ad/adset/campaign/account insights; async report runs; fields, breakdowns and date presets.

View vendor API documentation →

Pagination and rate limits

Pagination

Graph API uses cursor-based paging for most endpoints; Insights supports async report_run jobs and standard limit/after cursor paging for results. (github.com)

Rate limits

Insights has rate limits separate from general Marketing API limits and vary by ad-account tier; use async jobs and app-usage headers to reduce throttling. (mcp.waymark.network)

IMPLEMENTATION

Authentication at a glance

Uses OAuth 2.0 via a Meta App; Cyclr requires an App ID and App Secret and requests Marketing API scopes such as ads_read during consent. (community.cyclr.com)

Authentication method
OAuth 2.0
Credential required

App/Client ID; App/Client Secret; Valid OAuth Redirect URI; OAuth scopes (ads_read, ads_management).

Before you begin:

Meta App review and advanced permissions may be required; approval can take several days. (community.cyclr.com)

View setup guide

COMMON QUESTIONS

Frequently asked questions

It retrieves ad-account, campaign, ad-set and ad-level metrics (impressions, clicks, spend, actions, etc.) so you can build scheduled reports, on-demand dashboards and CSV exports inside your product. (postman.com)

It uses OAuth 2.0 via a Meta App: create a Facebook Developer app, supply App ID and App Secret in Cyclr, and request Marketing API scopes such as ads_read during the OAuth flow. (community.cyclr.com)

Yes. Cyclr supports per-account OAuth flows and Console-level settings so you can orchestrate per-tenant connections, throttle requests and reuse cycles across customers. (community.cyclr.com)

Yes. You can surface approved Insights methods as governed MCP workflow tools in Cyclr, letting product teams control which operations tenants may run and auditing usage. (community.cyclr.com)

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 Marketing API

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