List Facebook Lead Forms
GET/api/integrations/:integration_id/facebook_leadads/pages/:page_id/lead_forms
List lead forms for a Facebook page (for Flow Builder configuration).
This endpoint fetches all active lead forms associated with a Facebook page. Use this in Flow Builder to let users select which specific lead form should trigger the automation when a lead is submitted.
Args: integration_id: The ID of the Facebook Lead Ads integration page_id: The Facebook page ID
Returns: List of lead forms with id, name, status, and other details
Example: GET /api/integrations/abc-123/facebook_leadads/pages/123456/lead_forms Returns: [ { "id": "form_123", "name": "Contact Form", "status": "ACTIVE", "created_time": "2025-01-01T00:00:00+0000", "leads_count": 150 }, { "id": "form_456", "name": "Newsletter Signup", "status": "ACTIVE", "created_time": "2025-01-05T00:00:00+0000", "leads_count": 75 } ]
Flow Builder Usage:
- After user selects a page from the pages dropdown
- Flow Builder calls this endpoint to populate "Select Lead Form" dropdown
- User selects a specific lead form
- When that form is submitted, webhook triggers the automation
Request
Responses
- 200
- 404
- 422
Successful Response
Not found
Validation Error