# Meta Lead Ads + Krokul CRM

Yes. Krokul CRM integrates with Meta Lead Ads. Every instant form answer from a Facebook or Instagram ad becomes a contact and a deal in Krokul as soon as Meta reports it. When the deal moves forward, is won or is lost, Krokul sends that outcome back to Meta as an event, so Meta can optimise ad delivery for real sales. You connect it with the Krokul app in Zapier, Make, n8n or Albato, or with the Krokul API and webhooks.

**Status:** Via API and webhooks. **Automation platforms:** Zapier, Make, n8n, Albato.

## What your team gets

### An instant form answer opens a deal

A person submits the instant form under your Facebook or Instagram ad. Meta sends the leadgen webhook with the leadgen_id, and Krokul fetches the field_data of that answer through the Graph API. It then finds or creates the contact by phone or email, links the client company and opens a deal in the pipeline chosen for that form.

### Custom questions reach the manager

Meta stores each answer in field_data as a name and a list of values. Krokul maps the standard questions to contact fields and puts custom questions, such as budget or region, into custom deal fields or the first message on the deal. The manager calls with the context already in the card.

### Each form and ad keeps its source

The webhook carries form_id, ad_id and page_id. Krokul stores them on the deal as campaign tags and sets the source chosen for that form, so the sources report compares Meta forms with search, events and referrals by won revenue.

### Deal outcomes go back to Meta

When the deal reaches a qualified stage, is won or is lost, Krokul sends an event with the original form answer ID to Meta through the Conversions API. Meta can then optimise the campaign for answers that turn into sales.

## What moves between Meta Lead Ads and Krokul

| Meta Lead Ads | Krokul | Direction | When |
|---|---|---|---|
| leadgen webhook (leadgen_id, form_id, ad_id, page_id) | Incoming request, signed and checked | Meta → Krokul | Each form answer on a connected Page |
| field_data: full name, phone, email | Contact, matched by phone or email | Meta → Krokul | Fetched through the Graph API right after the webhook |
| field_data: company name | Client company on the contact | Meta → Krokul | Same answer |
| field_data: custom questions | Custom deal fields and first message | Meta → Krokul | Same answer, by the form mapping |
| Form and ad IDs | Source and campaign tags of the deal | Meta → Krokul | Same answer |
| Conversions API event with the form answer ID | Deal stage change, won or lost | Krokul → Meta | Stage events chosen in the connector |

## How to connect today

### Krokul app in Zapier, Make, n8n or Albato

1. Connect the Krokul app with an API key.
2. Use the Facebook Lead Ads trigger for new form answers with the Krokul actions Find Contact and Create Deal, one route per instant form.
3. Use the Krokul trigger Deal Won with the Facebook Lead Ads action Send Funnel Event to report outcomes from a platform.

### Custom flow through the Krokul API and webhooks

1. Issue a Krokul API key with write scopes for contacts, client companies and deals.
2. Subscribe your Meta app to the leadgen field of the Page and fetch field_data from the Graph API with a Page token that holds leads_retrieval.
3. Call contact/api-find and card/api-create, then keep the Meta form answer ID on the deal with externalRef/api-upsert so a repeat delivery finds the same deal.
4. Register a Krokul webhook for card.won and card.lost, verify x-crm-signature, and pass each outcome to the Meta Conversions API.

**Triggers:** New Lead.

**Actions:** Send Funnel Event.

### For integrators

For a custom route, a Meta app subscribes to the Page leadgen field and reads field_data from the Graph API with a Page token that has the leads_retrieval permission. Meta signs webhook deliveries with X-Hub-Signature-256. On the Krokul side, contact/api-find, card/api-create and externalRef/api-set with the Meta form answer ID keep repeat deliveries from opening a second deal. Krokul webhooks for card.won and card.lost are signed and logged, and a sandbox company is one call away.

[API documentation](https://app.krokul.com/api/v1/docs)

## Questions and answers

### Does Krokul integrate with Meta Lead Ads?

Yes. Krokul integrates with Meta Lead Ads through the Krokul app in Zapier, Make, n8n and Albato, and through its API and webhooks.

### Do Instagram ad forms work too?

Yes. Instagram instant forms belong to Meta Lead Ads and reach Krokul through the same Page connection.

### Why does Krokul need the leads_retrieval permission?

Meta sends the webhook with identifiers only. The answers come from a separate Graph API call, and Meta allows that call only with the leads_retrieval permission on the Page.

### What does Krokul send back to Meta?

An event per deal stage you choose, linked to the original form answer. Meta uses these events to see which answers became qualified or won deals.

## Limits

Ad creatives, budgets, audiences and the instant forms themselves stay in Meta Ads Manager. Krokul takes the answers and runs the sale that follows them.

## Related services

- [Google Ads](https://krokul.com/en/integrations/google-ads/index.md)
- [LinkedIn Lead Gen Forms](https://krokul.com/en/integrations/linkedin-lead-gen-forms/index.md)
- [Typeform](https://krokul.com/en/integrations/typeform/index.md)
- [Facebook Messenger](https://krokul.com/en/integrations/facebook-messenger/index.md)
- [Instagram Direct](https://krokul.com/en/integrations/instagram-direct/index.md)

[Forms and ad inquiries](https://krokul.com/en/integrations/category/lead-capture/index.md)

Meta, Facebook and Instagram are trademarks of Meta Platforms, Inc. Krokul is not affiliated with Meta.

Updated: 2026-10-12

---

App: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs