Facebook Forms

Connect your Facebook account to seamlessly import Lead Ad Forms from your Facebook Pages. Once integrated, all existing and future form submissions are automatically synced to your dashboard, giving you a centralized place to view and forward lead data.

Log in to your account and navigate to the Facebook Forms page.

Click the "Add new Facebook Form" button.

For the first time you have to authenticate with your Facebook profile by clicking on "Add new Facebook profile".

A Facebook login window will appear. Sign in with your Facebook credentials.

Grant the requested permissions to allow our app to access your Pages and Lead Ad Forms.

Once authenticated, you will be returned back to Branchside page.

You can add multiple Facebook profiles.

After connecting your Facebook profile click on "Add new Facebook Form" button again.

Select your authenticated profile and click "Next step".

Select a Page to view its available Lead Ad Forms.

Select the form you'd like to sync and click "Add form" button.

Once imported, the app will immediately begin fetching all existing submissions for that form. This process will run in the background, so you'll have to wait for a while to view all your existing submissions from that form.

To view imported leads data simply click on "View Leads" button next to the form.

Once a form is imported, new submissions are fetched automatically — no manual action required. Every time a user submits your Facebook Lead Ad Form, the entry will appear in your dashboard in real time.

There is nothing additional to configure. The sync remains active as long as your Facebook profile is connected.

You can forward every new submission data to external services using webhooks.

First you have to create a webhook integration.

Click on three dots next to the form and go to "Advanced settings".

In the "Webhooks" tab select the webhook you want to trigger for every new submission. You can select multiple webhooks, so form data will be sent to every webhook.

Each time a submission is received, a POST request will be sent to your webhook URL with the lead data in JSON format.

Payload example:

{
  "form": {
    "type": "facebook",
    "id": "<ORIGIN_FORM_ID>",
    "name": "Testing Integration",
    "fields": {
      "email": {
        "key": "email",
        "label": "Email",
        "type": "EMAIL",
        "id": "<ORIGIN_FIELD_ID>"
      },
      "full_name": {
        "key": "full_name",
        "label": "Full name",
        "type": "FULL_NAME",
        "id": "<ORIGIN_FIELD_ID>"
      },
      "phone_number": {
        "key": "phone_number",
        "label": "Phone number",
        "type": "PHONE",
        "id": "<ORIGIN_FIELD_ID>"
      }
    }
  },
  "data": {
    "email": "[email protected]",
    "full_name": "Test User",
    "phone_number": "+100000000"
  },
  "lead_id": <ORIGIN_LEAD_ID>
}

In the Advanced settings in the "Config" tab you can specify additional data you want to pass with every POST request to your webhook integration.

These key-values will be included in the form.config object in the payload.

Payload example with config:

{
  "form": {
    "type": "facebook",
    "id": "<ORIGIN_FORM_ID>",
    "name": "Testing Integration",
    "fields": {
      "email": {
        "key": "email",
        "label": "Email",
        "type": "EMAIL",
        "id": "<ORIGIN_FIELD_ID>"
      },
      "full_name": {
        "key": "full_name",
        "label": "Full name",
        "type": "FULL_NAME",
        "id": "<ORIGIN_FIELD_ID>"
      },
      "phone_number": {
        "key": "phone_number",
        "label": "Phone number",
        "type": "PHONE",
        "id": "<ORIGIN_FIELD_ID>"
      }
    },
    "config": {
        "custom_name": "Custom form name for my integration",
        "webhook": {
          "extra": "Config key for this nested object is `webhook.extra`"
        }
    }
  },
  "data": {
    "email": "[email protected]",
    "full_name": "Test User",
    "phone_number": "+100000000"
  },
  "lead_id": <ORIGIN_LEAD_ID>
}