Skip to main content
The first message from a WhatsApp, Messenger, or Instagram ad sends Lead submitted to Meta on its own. Meta counts a repeat of the same event id as one lead for about 48 hours. A Facebook lead form, a qualified lead, and a sale still reach Meta only when a published workflow says so. Meta Conversions API stores the lead form in Karzoun and can send a later conversion or update a customer-list audience. This guide covers the connection, where the forms show up, and which action sends each kind of conversion.

Before you start

Install Meta Conversions API from the marketplace, then connect it under Settings → Applications until the status is Connected.

Where a lead shows up

Facebook and Instagram forms are not created with Create Popup, and they do not use this app’s token. Connect the Facebook Page. Karzoun then pulls the leads Meta still has (up to 90 days) and receives new ones on the Page webhook. A form filled from the Instagram account linked to that Page arrives the same way. The rows show under Popups → Facebook lead forms. Reconnect a Page that was connected before lead forms were enabled. Open the form name to see submissions. One person is one row. Each question is one column, in the form’s order, followed by the campaign, the ad, a link that opens that ad, and paid or organic. Name, phone, and email are written on the contact. Matching is by phone, then email. Other answers stay on the submission. You can open submissions or archive the row. Edit, embed, duplicate, and delete stay unavailable.
Saving the lead does not send a Lead event to Meta. A later conversion action does that.

What to put in the workflow

Click conversions

Lead submitted is sent when the first ad message arrives, and it is not in the click action’s event list. Use Send WhatsApp conversion, Send Messenger conversion, or Send Instagram conversion for Qualified lead, Purchase, and the other events. Each of those sends only when that channel has an ad click from the last 7 days. Otherwise the step is skipped. A repeat uses the same event id, and Meta counts that as one event for about 48 hours. A new Order ID is a new purchase. Purchase needs Value and Currency. Phone and email are not sent with a click. Reconnect WhatsApp after this change so the account token includes permission to send events. Reconnect the Facebook Page so its token includes page_events.

Send customer conversion

This action is on the conversions app. Pick an Event. Purchase needs Value and Currency. The customer is matched by phone or email. Lead ID is optional. When the workflow starts from Lead form received, pass that trigger’s lead id into this field. Leave it empty when the conversion has no Meta lead. Click ID is optional. Pass the website ad click, fbclid, when the order came from the site. Also pass Page URL and Browser from that visit. Leave Click ID empty when there is no website click. With neither a phone nor an email, the step is skipped. A Test event code on the action replaces the one saved on the connection.

Audiences

Add to audience and Remove from audience need adsAccessToken and an audience id. With neither a phone nor an email, the step is skipped. Creating the audience from the connect screen is not available. Create the list in Meta Ads Manager and paste its id into the action.
Do not put a conversion action on Lead form received if you still need to qualify or close the sale. Store the lead, then send the conversion when the pipeline stage changes or when the person joins or leaves a segment.

Troubleshooting


Last modified on November 13, 2026