--- title: "Facebook Insights Connector | Integrate with Your App" description: "Embed Meta (Facebook) ad performance metrics in your SaaS product using the Facebook Insights connector for scheduled and on-demand reports." url: "https://cyclr.com/integrate/facebook-insights" canonical: "https://cyclr.com/integrate/facebook-insights" served_via: "https://cyclr.com/.well-known/agent-markdown" --- ![Facebook Insights connector icon](https://cyclr.com/nitropack_static/sXmTfWgCNjOnvnYlyrLZVbIAkjEZnoiJ/assets/images/optimized/rev-31a2a0c/cyclr.com/wp-content/uploads/2022/03/ext-269.jpg) # 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](https://cyclr.com/get-started) [Talk to an integration expert](https://cyclr.com/get-started/) AuthenticationOAuth 2.0Connector typeMarketingAvailable inCyclr Console ActionsMCP toolsWorkflows 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](https://community.cyclr.com/connector-guides/facebook/facebook-setup?utm_source=openai)) ### Why use Cyclr? Embed white-label, in-app reporting without reimplementing OAuth, polling or throttling logic. Reuse Cyclr cycles to orchestrate async Insights jobs, throttle per ad account, cache or transform metrics, and control which methods appear in your embedded marketplace or MCP tools. Cyclr handles multi-tenant orchestration and governance while your product exposes the results. 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. Search connector methods INTEGRATIONS + MCP TOOLS ### Use any Facebook Insights method in an integration or as an MCP tool Every available connector method can be added to an integration workflow built with Cyclr or exposed as a governed MCP tool. Use the same multi-tenant authentication, orchestration and governance layer to deliver customer-facing integrations and AI-agent capabilities inside your SaaS product. [Explore MCP PaaS](https://cyclr.com/product/mcp-paas/) 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. ### Can’t find the method your integration needs? Cyclr can extend this connector with additional API methods to support your integration requirements. [Get in touch](https://cyclr.com/contact/) 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`AuthenticationOAuth 2.0Credentials 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 →](https://developers.facebook.com/docs/marketing-api/insights/?utm_source=cyclr) ### 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](https://github.com/oliverames/meta-mcp-server/blob/main/docs/marketing-api/insights-api.md?utm_source=cyclr)) #### 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](https://mcp.waymark.network/r/3dddda63-53cf-4899-ab8e-929c99a26f4f?utm_source=cyclr)) 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](https://community.cyclr.com/connector-guides/facebook/facebook-setup?utm_source=openai)) Authentication methodOAuth 2.0Credential 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](https://community.cyclr.com/connector-guides/facebook/facebook-setup?utm_source=openai)) [View setup guide](https://community.cyclr.com/connector-guides/facebook/facebook-setup) AI INTEROPERABILITY ## Use Facebook Insights methods in MCP servers Cyclr can expose any available Facebook Insights connector method as a governed MCP tool. - Expose connector methods as MCP tools - Combine them with your product data and other connectors - Apply tenant-aware access and governance - Orchestrate end-to-end MCP-triggered workflows [Explore MCP PaaS](https://cyclr.com/product/mcp-paas/) COMMON QUESTIONS ## Frequently asked questions What can the Facebook Insights connector integrate or automate? *↓* 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](https://www.postman.com/meta/facebook-marketing-api/documentation/0zr4mes/facebook-marketing-api-mapi?entity=request-31691153-6b7e9445-1832-42ae-b40a-bdd1b831f714&utm_source=cyclr)) How does authentication work for the connector? *↓* 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](https://community.cyclr.com/connector-guides/facebook/facebook-setup?utm_source=openai)) Can I embed this for many customer accounts and manage multi-tenant access? *↓* 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](https://community.cyclr.com/user-documentation/connectors/introduction-to-connector-guides)) Can supported Insights methods be exposed as governed MCP tools? *↓* 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](https://community.cyclr.com/user-documentation/connectors/introduction-to-connector-guides)) KEEP EXPLORING ## Related resources and connectors [Documentation ### What is iPaaS? **Read more →**](https://cyclr.com/blog/what-is-ipaas)[Product ### How to develop an API – Best Practices to Follow from Cyclr Developers **Read more →**](https://cyclr.com/blog/how-to-develop-an-api)[Product ### MCP PaaS **Read more →**](https://cyclr.com/product/mcp-paas)[Related connector ### Facebook Audiences Related Social Media connector for customer-facing integration workflows.](https://cyclr.com/integrate/facebook-audiences)[Related connector ### Facebook Conversions Related Social Media connector for customer-facing integration workflows.](https://cyclr.com/integrate/facebook-conversions)[Related connector ### Facebook Marketing API Related Social Media connector for customer-facing integration workflows.](https://cyclr.com/integrate/facebook-marketing-api) ## Let Cyclr handle the integrations. You focus on building the product your customers love. [Start building for free](https://cyclr.com/get-started/request-free-trial) [Get a demo](https://cyclr.com/get-started/book-a-demo) Embedded iPaaS for SaaS [https://www.linkedin.com/company/cyclr-systems/](https://www.linkedin.com/company/cyclr-systems/) [https://www.youtube.com/channel/UCtkjPj2Lq-Ox2q3_e5MRfrg](https://www.youtube.com/channel/UCtkjPj2Lq-Ox2q3_e5MRfrg) [https://www.facebook.com/cyclrautomation](https://www.facebook.com/cyclrautomation) - [Embedded iPaaS Overview](https://cyclr.com/product) - [SaaS Embedded iPaaS](https://cyclr.com/product) - [Service Embedded iPaaS](https://cyclr.com/product/service-embedded-ipaas) - [Enterprise Embedded iPaaS](https://cyclr.com/product/branded-embedded-ipaas) - [AI Orchestration](https://cyclr.com/ai-orchestration) - [Case Studies](https://cyclr.com/case-studies) - [Build vs Buy Integration](https://cyclr.com/blog/build-or-buy-choosing-an-integration-solution) - [Cyclr Alternatives](https://cyclr.com/alternatives) - [Cyclr vs. Paragon](https://cyclr.com/alternatives/cyclr-vs-paragon) - [Cyclr vs. Prismatic](https://cyclr.com/alternatives/cyclr-vs-prismatic) - [About Us](https://cyclr.com/company/about-us) - [Contact](https://cyclr.com/contact) - [Blog](https://cyclr.com/blog) - [Partner Programme](https://cyclr.com/partners) - [Working at Cyclr](https://cyclr.com/company/working-at-cyclr) ### Contact **UK:** (0330) 010 2525 **US:** (646) 585 2525 CO.5C, Corinthian House, 17 Lansdowne Road, Croydon, CR0 2BX ### Popular Connectors - [Salesforce](https://cyclr.com/integrate/salesforce) - [HubSpot](https://cyclr.com/integrate/hubspot) - [Microsoft Dynamics](https://cyclr.com/integrate/microsoft-dynamics-crm) - [Shopify](https://cyclr.com/integrate/shopify) - [NetSuite](https://cyclr.com/integrate/netsuite) - [Amazon S3](https://cyclr.com/integrate/amazon-s3) - [Sage 200](https://cyclr.com/integrate/sage-200) ### Top Connector Categories - [Accounting](https://cyclr.com/connectors/category/accounting) - [CRM](https://cyclr.com/connectors/category/crms) - [Database](https://cyclr.com/connectors/category/databases) - [Email Marketing](https://cyclr.com/connectors/category/email-marketing) - [ERP](https://cyclr.com/connectors/category/erp) - [HR/Payroll](https://cyclr.com/connectors/category/hr-payroll) - [Product Management](https://cyclr.com/connectors/category/product-management) ### Trending Resources - [What is an Embedded iPaaS?](https://cyclr.com/blog/what-is-an-embedded-ipaas) - [SaaS Integration: How do you do it?](https://cyclr.com/blog/how-do-you-integrate-with-multiple-saas-products) - [AI Resources](https://cyclr.com/resources/ai) - [MCP Use Case Directory Tool](https://cyclr.com/resources/mcp-discovery-tool) - [API Integration](https://cyclr.com/resources/api-integration) - [Embedded iPaaS](https://cyclr.com/resources/embedded-ipaas) - [Cost Calculator](https://cyclr.com/resources/integration-cost-calculator) ### Common Use Cases - [SaaS Developers](https://cyclr.com/use-cases/saas-developers) - [Product Managers](https://cyclr.com/use-cases/product-managers) - [API Teams](https://cyclr.com/use-cases/api-teams) - [CFOs](https://cyclr.com/use-cases/cfo-finance-teams) - [B2B SaaS Platforms](https://cyclr.com/use-cases/established-saas-platforms) - [Enterprise Organizations](https://cyclr.com/enterprise) - [Composable Commerce](https://cyclr.com/use-cases/composable-commerce) MENUMENU - [Website Terms](https://cyclr.com/legal/website) - [Privacy Policy](https://cyclr.com/privacy-policy) - [Terms and Conditions](https://cyclr.com/terms-and-conditions) - [AI Policy](https://cyclr.com/ai-policy) - [DPA](https://cyclr.com/data-protection-agreement) - [SLA](https://cyclr.com/sla) - [GDPR](https://cyclr.com/legal/gdpr-compliance) - [Sitemap](https://cyclr.com/sitemap) - [Cookie Settings](https://cyclr.com/#) © 2026 Cyclr Systems Ltd. All rights reserved. Registered business number: 08790783. VAT Number GB218625701. ## Structured data ```json { "@context": "https://schema.org", "@graph": [ { "@type": [ "WebPage", "ItemPage" ], "@id": "https://cyclr.com/integrate/facebook-insights", "url": "https://cyclr.com/integrate/facebook-insights", "name": "Facebook Insights Connector | Low-Code Facebook Insights Integration | Cyclr", "isPartOf": { "@id": "https://cyclr.com/#website" }, "primaryImageOfPage": { "@id": "https://cyclr.com/integrate/facebook-insights#primaryimage" }, "image": { "@id": "https://cyclr.com/integrate/facebook-insights#primaryimage" }, "thumbnailUrl": "https://cyclr.com/wp-content/uploads/2022/03/ext-269.jpg", "datePublished": "2022-03-21T15:51:00+00:00", "dateModified": "2026-02-17T16:19:01+00:00", "description": "Provide your SaaS's users with in-app Facebook Insights integrations with Cyclr's low-code embedded iPaaS solution.", "breadcrumb": { "@id": "https://cyclr.com/integrate/facebook-insights#breadcrumb" }, "inLanguage": "en-GB", "potentialAction": [ { "@type": "ReadAction", "target": [ "https://cyclr.com/integrate/facebook-insights" ] } ] }, { "@type": "ImageObject", "inLanguage": "en-GB", "@id": "https://cyclr.com/integrate/facebook-insights#primaryimage", "url": "https://cyclr.com/wp-content/uploads/2022/03/ext-269.jpg", "contentUrl": "https://cyclr.com/wp-content/uploads/2022/03/ext-269.jpg", "width": 200, "height": 200 }, { "@type": "BreadcrumbList", "@id": "https://cyclr.com/integrate/facebook-insights#breadcrumb", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Social Media", "item": "https://cyclr.com/connectors/category/social-media" }, { "@type": "ListItem", "position": 2, "name": "Facebook Insights" } ] }, { "@type": "WebSite", "@id": "https://cyclr.com/#website", "url": "https://cyclr.com/", "name": "Cyclr", "description": "Embedded iPaaS for scaling SaaS integrations", "publisher": { "@id": "https://cyclr.com/#organization" }, "potentialAction": [ { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://cyclr.com/?s={search_term_string}" }, "query-input": { "@type": "PropertyValueSpecification", "valueRequired": true, "valueName": "search_term_string" } } ], "inLanguage": "en-GB" }, { "@type": "Organization", "@id": "https://cyclr.com/#organization", "name": "Cyclr", "url": "https://cyclr.com/", "logo": { "@type": "ImageObject", "inLanguage": "en-GB", "@id": "https://cyclr.com/#/schema/logo/image/", "url": "https://cyclr.com/wp-content/uploads/2026/09/cyclr-logo-blue@4x-scaled.png", "contentUrl": "https://cyclr.com/wp-content/uploads/2026/09/cyclr-logo-blue@4x-scaled.png", "width": 2560, "height": 1053, "caption": "Cyclr" }, "image": { "@id": "https://cyclr.com/#/schema/logo/image/" }, "sameAs": [ "https://www.facebook.com/cyclrautomation", "https://x.com/cyclr", "https://www.linkedin.com/company/10066377/", "https://www.youtube.com/channel/UCtkjPj2Lq-Ox2q3_e5MRfrg", "https://www.g2.com/products/cyclr", "https://www.pinterest.co.uk/cyclrsystems/" ], "description": "Embedded iPaaS for B2B SaaS companies - enabling interoperability between APIs, LLMs, on-prem and Cloud systems, with a secure, multi-tenanted architecture for governance and scaling.", "telephone": "(0330) 010 2525", "legalName": "Cyclr Systems Limited", "vatID": "GB218625701", "numberOfEmployees": { "@type": "QuantitativeValue", "minValue": "11", "maxValue": "50" }, "actionableFeedbackPolicy": "https://cyclr.com/legal/website", "correctionsPolicy": "https://cyclr.com/legal/website", "ethicsPolicy": "https://cyclr.com/company" } ] } { "@context": "https://schema.org", "@graph": [ { "@type": "SoftwareApplication", "@id": "https://cyclr.com/integrate/facebook-insights#connector", "name": "Facebook Insights Connector", "url": "https://cyclr.com/integrate/facebook-insights", "applicationCategory": "DeveloperApplication", "operatingSystem": "Web", "description": "Embed Meta (Facebook) ad performance metrics in your SaaS product using the Facebook Insights connector for scheduled and on-demand reports.", "featureList": [ "Ad insights retrieval; async report_run support; breakdowns; date presets; cursor paging; per-account scoping" ] }, { "@type": "TechArticle", "@id": "https://cyclr.com/integrate/facebook-insights#article", "headline": "Facebook Insights Connector | Integrate with Your App", "description": "Embed Meta (Facebook) ad performance metrics in your SaaS product using the Facebook Insights connector for scheduled and on-demand reports.", "mainEntityOfPage": "https://cyclr.com/integrate/facebook-insights", "dateModified": "2026-09-07", "about": { "@id": "https://cyclr.com/integrate/facebook-insights#connector" } }, { "@type": "BreadcrumbList", "@id": "https://cyclr.com/integrate/facebook-insights#breadcrumb", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Connectors", "item": "https://cyclr.com/connectors/" }, { "@type": "ListItem", "position": 2, "name": "Marketing", "item": "https://cyclr.com/connectors/category/marketing" }, { "@type": "ListItem", "position": 3, "name": "Facebook Insights Connector", "item": "https://cyclr.com/integrate/facebook-insights" } ] }, { "@type": "FAQPage", "@id": "https://cyclr.com/integrate/facebook-insights#faq", "mainEntity": [ { "@type": "Question", "name": "What can the Facebook Insights connector integrate or automate?", "acceptedAnswer": { "@type": "Answer", "text": "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](https://www.postman.com/meta/facebook-marketing-api/documentation/0zr4mes/facebook-marketing-api-mapi?entity=request-31691153-6b7e9445-1832-42ae-b40a-bdd1b831f714&utm_source=cyclr))" } }, { "@type": "Question", "name": "How does authentication work for the connector?", "acceptedAnswer": { "@type": "Answer", "text": "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](https://community.cyclr.com/connector-guides/facebook/facebook-setup?utm_source=openai))" } }, { "@type": "Question", "name": "Can I embed this for many customer accounts and manage multi-tenant access?", "acceptedAnswer": { "@type": "Answer", "text": "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](https://community.cyclr.com/user-documentation/connectors/introduction-to-connector-guides))" } }, { "@type": "Question", "name": "Can supported Insights methods be exposed as governed MCP tools?", "acceptedAnswer": { "@type": "Answer", "text": "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](https://community.cyclr.com/user-documentation/connectors/introduction-to-connector-guides))" } } ] } ] } ```