Skip to main content
POST
The Meta Instant Forms (lead forms) on a Facebook Page, live from Meta: id, name, lead count and whether the form has a privacy policy link (Meta refuses lead ads whose form has none). Use for Leads campaigns with conversionLocation INSTANT_FORMS: pass the chosen form's id as leadFormId to build_campaign. pageId comes from get_launch_options; it is optional when the ad account has exactly one Page.

Authorizations

Authorization
string
header
required

AdStellar API key (ast_live_...)

Body

application/json
adAccountId
string
required

Meta ad account id from list_ad_accounts (e.g. act_123).

Minimum string length: 1
pageId
string

Facebook Page id from get_launch_options. Optional when the account has one Page.

workspaceId
string<uuid>

Workspace to act in (must be granted to this credential). Omit for the primary workspace.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

Tool result