Meta Lead Ads
Receive leads in real-time from Facebook and Instagram Lead Ads.
Lead Generationoauthproxywebhook_receivelead_sync
Connect Meta Lead Ads
Meta Lead Ads uses OAuth for authentication. Redirect your user to the login URL to start the authorization flow. After the user authorizes access, the callback is handled automatically.
# Redirect user to start OAuth flow
GET /auth/meta_lead_ads/login?account_id=YOUR_ACCOUNT_ID&redirect_uri=https://your-app.com/callback
# Callback handled automatically at
GET /auth/meta_lead_ads/callback
Subscribe to Webhooks
Set up a webhook subscription to receive real-time events from Meta Lead Ads:
POST /connect/v1/webhooks/meta_lead_ads/subscribe
# Headers
Authorization: YOUR_JWT_TOKEN
Content-Type: application/json
# Body
{
"url": "https://your-app.com/webhook"
}
List your existing webhook subscriptions:
GET /connect/v1/webhooks/meta_lead_ads/subscriptions
# Headers
Authorization: YOUR_JWT_TOKEN
Make API Calls via Proxy
Use the proxy endpoint to make authenticated API calls to Meta Lead Ads without managing tokens yourself. Calimatic Connect handles credential injection and token refresh automatically.
POST /connect/v1/proxy/meta_lead_ads
# Headers
Authorization: YOUR_JWT_TOKEN
Content-Type: application/json
# Body
{
"method": "GET",
"path": "/me"
}
Check Status
Verify whether your Meta Lead Ads connection is active and credentials are valid:
GET /connect/v1/providers/meta_lead_ads/status
# Headers
Authorization: YOUR_JWT_TOKEN
Disconnect
Remove the Meta Lead Ads connection and revoke stored credentials:
DELETE /connect/v1/providers/meta_lead_ads/disconnect
# Headers
Authorization: YOUR_JWT_TOKEN