Facebook Marketing API

Partner Setup

Facebook Marketing API uses OAuth 2. You should sign up for an application on Facebook first and get an OAuth client ID and client secret.

Here is the official documentation for creating a Facebook app:


  1. Log into your Facebook account.
  2. Create a Facebook Developer account if you don’t already have one: https://developers.facebook.com/
  3. Create a new Facebook app: https://developers.facebook.com/apps/

    Below are the details you should provide:

    Platform: Website

    Name: your application name

    App Domain: (two domains required) my.cyclr.com and your Cyclr partner domain e.g. app-h.cyclr.com

    Website: Your Cyclr service domain, e.g. https://app-h.cyclr.com/. This can be found in your Cyclr Console under Settings > Integration Settings > Service Domain.

    Application Type: Web Application

  4. Go to Cyclr Console (https://my.cyclr.com/console) > Connectors > Connector Library > Facebook Marketing API > Setup

    Client ID: This is the App ID displayed after you create the Facebook app

    Client Secret: This is the App Secret displayed after you create the Facebook app

  5. Don’t forget to make your Facebook app public. It’s in Development by default.

Your Facebook Marketing API connector is now set up! You can test it by installing it in one of your user accounts.

API Integration Guide

Facebook Marketing API uses OAuth 2 Authorisation Code flow. It requires your end users to sign into Facebook and grant Cyclr access to their account.

To do this, call /UpdateAccountConnectorOAuth with a one-time sign-in token.

Tags: connector
Edit me