Skip to content
  1. Home
  2. Help center
  3. Connections
  4. Connect Facebook lead forms

Connect Facebook lead forms

Last updated:

A lead form on Facebook is filled in and submitted without the person ever reaching your site, so the website connection never sees them. This connection receives those leads from Facebook and tags each one with the campaign, ad set and ad it came from, so they land in the same report rows as the spend from Facebook Ads.

It is a separate connection from Facebook Ads, and both are needed: one brings the leads, the other brings the money.

Set up the connection in KO

  1. In Connects, click Add connect….
  2. In the Websites, quizzes, lead forms, chats category, choose Facebook Lead Form and click Connect.
  3. In Connection, click Connect and sign in to Facebook in the window that opens.
  4. In that window, tick every Page and ad account — see below.
  5. Choose the Page the forms belong to. Below the field, KO shows the permissions Facebook gave for this Page (Permissions: …).
  6. In Forms, tick the forms to collect. Reload data refreshes the list from Facebook. New items to enable by default also includes forms that appear on the Page later.
  7. Leave Apply parameters to leads alone — transforming incoming values is set up through technical support.

KO collects the leads of the ticked forms from Facebook itself, on its sync schedule. You do not need to subscribe the Page to anything in Facebook.

Tick every Page and ad account

Facebook keeps permissions as one list per user and rewrites that list on every authorisation. Tick fewer boxes than last time and access disappears from connections set up earlier — in this project and in others that authorised as the same Facebook user. Leads and spend simply stop arriving for them.

So: tick all Pages and all ad accounts, even the ones this project does not need.

If the window shows no list at all, click Edit previous settings — Facebook hides the list when the same user authorises again.

Match the tags to the Facebook Ads connection

A lead form submission has no site visit behind it, so KO builds the source itself: it takes the Ad tags section of this connection and fills the placeholders from the campaign the lead came from.

FieldDefault
utm_sourcefacebook-ads
utm_mediumcpc
utm_campaign{{campaign.id}}_{{campaign.name}}
utm_content{{adset.name}}|{{ad.name}}
utm_term({{site_source_name}}: {{ad.id}})

Keep these identical to the Ad tags of the Facebook Ads connection. They are what makes spend and leads meet in one row — set differently, the campaign shows spend without leads and leads without spend, at the same time.

Turn the connection on

When you have set all the options, switch the connection status to Active:

  • Active — everything works.
  • Setting up — everything works, but data updates are paused.
  • Archived — the connection is off; data and statistics are kept.
  • Delete — removes the connection’s data and statistics.

Check that data is coming in

  • Below the Page field you see a list of permissions, not Permissions: none.
  • Forms lists your forms and keeps the ones you ticked after a reload.
  • Submit a test lead through Facebook’s lead ads testing tool. After the next sync it appears in Leads, with the campaign in its source if it came from an ad.

If it doesn’t add up

No Pages in the list. The authorisation did not grant access to them. Authorise again and tick everything, including Pages this project does not need.

The Page shows “Permissions: none” and there are no forms. The authorisation gave no rights to this Page. It is the same cause as above — the boxes ticked in the Facebook window — and re-authorising with all boxes ticked is the fix.

A new form’s leads do not arrive. Forms are collected by explicit choice. Press Reload data in Forms and tick the new one, or turn on New items to enable by default so new forms are picked up on their own. Until then Facebook accepts submissions that KO never receives.

Leads arrive with no campaign in the source. Only leads produced by an ad carry a campaign. A form submitted from an organic post has none, and the campaign part of the source comes out empty — that is the data, not a fault of the connection.

Leads and spend sit in separate rows of the report. The Ad tags of this connection and of the Facebook Ads connection differ. Make them identical.

A connection that used to work stopped. KO reports that the link with Facebook dropped and the account has to be reconnected. Two usual causes: someone re-authorised the same Facebook user with fewer Pages ticked, or the Facebook password changed.