​
Setup Guide

You can find your Facebook Ads app credentials by visiting your Facebook Developer App Settings.
Note: You’ll need to create a new Facebook Ads app if you don’t already have one.
You’ll need the following information to set up your Facebook Ads App with Paragon Connect:
  • Client ID
  • Client Secret
  • Scopes Requested

​
Add the Redirect URL to your Facebook Ads app

Paragon provides a redirect URL to send information to your Facebook Ads app. To add the redirect URL to your Facebook Ads app:
  1. Copy the link under “Redirect URL” in your integration settings in Paragon. The Redirect URL is:
https://passport.useparagon.com/oauth
  1. Log into your Facebook Developer Portal.
  2. Select your app from the list of apps.
  3. Under Add a product, select Facebook Login.
  4. Under Valid OAuth Redirect URIs, paste-in the redirect URL from Paragon. The redirect URL can be found in Step 1.
  5. Press the blue Save changes button to confirm your changes.

​
Add your Facebook Ads app to Paragon

  1. Select Facebook Ads from the Integrations Catalog.
  2. Under Integrations > Connected Integrations > Facebook Ads > App Configuration > Configure, fill out your credentials in their respective sections:
  • Client ID:
    1. Log in to your Facebook Ads dashboard.
    2. Select your application.
    3. Select Settings > Basic from the sidebar.
    4. Copy the App ID to use in Paragon Connect.
  • Client Secret:
    1. Log in to your Facebook Ads dashboard.
    2. Select your application.
    3. Select Settings > Basic from the sidebar.
    4. Copy your App Secret to use in Paragon Connect.
Press the purple “Save Changes” button to save your credentials.
Note: Leaving the Client ID and Client Secret blank will use Paragon development keys.

​
Connecting to Facebook Ads

Once your users have connected their Facebook Ads account, you can use the Paragon SDK to access Facebook Ads on behalf of connected users. See the Facebook Ads REST API documentation for their full API reference. Any Facebook Ads API endpoints can be accessed with the Paragon SDK as shown in this example.
JavaScript
// You can find your project ID in the Overview tab of any Integration.

// Authenticate the user
paragon.authenticate(<ProjectID>, <Paragon User Token>);

// Get Campaigns
await paragon.request(‘facebookAds’, 'act_<AD_ACCOUNT_ID>/campaigns', {
  method: 'GET'
})

// Create a Campaign
await paragon.request('facebookAds', 'act_<AD_ACCOUNT_ID>/campaigns' , {
  method: 'POST',
  body: {
    name: "My First Campaign",
    objective: "POST_ENGAGEMENT",
    status: "PAUSED",
    special_ad_categories: []
  }
})

​
Building Facebook Ads workflows

Once your Facebook Ads account is connected, you can add steps to perform the following actions:
  • Create Campaign
  • Update Campaign
  • Get Campaigns
  • Get Campaign by ID
  • Create Ad Set
  • Update Ad Set
  • Get Ad Sets
  • Get Ad Set by ID
  • Create Ad
  • Update Ad
  • Get Ad by ID
  • Build Ad Creative Object
  • Create Ad Creative
  • Create Lead Gen Form
  • Send Purchase Event
  • Send Lead Event
  • Send Funnel Event
You can also use the Facebook Ads Request step to access any of Facebook Ads’s API endpoints without the authentication piece. When using Facebook Ads, you can reference data from previous steps by typing {{ to invoke the variable menu.