Facebook Marketing API – Webhook Usage

The Cyclr Facebook Marketing API Connector has the following Webhook Methods available:

  • Webhooks > Generic Webhook
  • Webhooks > Leadgen Webhook

You must manually add webhooks to your Facebook app to receive requests in a Cycle.

The following describes setting up a webhook to receive real-time notifications of changes to a Page’s Lead ads.

Any combination of object and fields can be used.

In these cases, the Webhooks > Generic Webhook Method should be used. As this webhook is generic, request field values should be mapped as request fields in the format:

[entry].[changes].value.<Key>

Add a webhook to a Cycle

From a Cycle:

  1. Add the Webhooks > Leadgen Webhook method to a Cycle.
  2. Select Step Setup.
  3. Make a note of the Cyclr Webhook URL shown on the Step.

Configure the webhook within Facebook

NOTE: The Cycle containing the webhook must be started before completing the below.

From the Facebook Apps page:

  1. Select the app you wish to configure webhooks for.
  2. Select Webhooks from the left side menu.
  3. Under the Select product heading, select the dropdown and select Page.
  4. Under the Configure a webhook heading:
    1. Enter the Cyclr Webhook URL in the Callback URL text box.
    2. Enter any text in the Verify token text box.
    3. Select Verify and save.
  5. Once the page reloads, under the Select product heading, select the dropdown and select Page.
  6. Under the Configure a webhook heading, select the toggle next to the leadgen webhook field.