Skip to main content

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:

  1. After user selects a page from the pages dropdown
  2. Flow Builder calls this endpoint to populate "Select Lead Form" dropdown
  3. User selects a specific lead form
  4. When that form is submitted, webhook triggers the automation

Request

Responses

Successful Response