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

Changed in 3 of the 56 revisions of this API.7

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added