Set up Facebook Lead Ads
alphaSetup guide coming soon. Facebook Lead Ads has no step-by-step guide in the catalogue yet. Until it does, here is what a connection needs, and where to read more.
What a connection holds
| Field | Secret | Where it comes from |
|---|---|---|
App IDclientId | Not secret | From the Meta app dashboard. ONE value for the whole installation. |
App secret (OAuth)clientSecret | Secret | The same app's client secret, used to exchange the authorization code. |
App secret (proof and webhook signature)appSecret | Secret | TWO roles, one value. It keys the appsecret_proof HMAC on outgoing calls, and it is also what Meta signs INCOMING webhook deliveries with -- there is no per-endpoint webhook secret in the Graph API the way there is in Stripe. It is never sent in either direction. For a standard Meta app this is the same value as the OAuth client secret; it is declared separately because they are different roles, and an app that rotates one without the other should not silently break the other. |
Page access tokenpageAccessToken | Secret | PER PAGE, not per user. Leads belong to a Page's forms, and Meta requires the token to be held by somebody who can advertise on the ad account. A long-lived page token lasts about 60 days and is re-authorised rather than refreshed. |
Links
Facebook Lead Ads API docs
Consent is requested at https://www.facebook.com/v25.0/dialog/oauth
React (editor surface, every host)
@particle-academy/facebook-lead-ads-ui v0.2.1
