Lead Gen

List lead forms

Lists the Lead Gen forms owned by the account. Meta: forms on the connected Facebook Page. Pass either the metaads ads connection (the Page is taken from the Facebook account linked to it) or the Facebook account itself. LinkedIn: forms owned by the ad account's Company Page. Pass adAccountId (LinkedIn forms are org-owned). Requires the Ads add-on.

get/v1/ads/lead-forms

Query parameters

accountIdstring required

Connected Meta ads, Facebook or LinkedIn ads account ID. A Meta ads connection resolves its Page through the Facebook account linked to the same profile.

adAccountIdstring

LinkedIn only: the LinkedIn ad account id (used to resolve the owning organization). Required for LinkedIn.

limitinteger
cursorstring

Response

Forms list.

statusstring
formsobject[]

Example response

{
  "status": "success"
}

Changes