Lead Gen

List submitted leads

Changed on

Lists the leads submitted through your Meta or LinkedIn lead forms, newest first.

Returns submitted Lead Gen leads for your team, newest-first, with keyset pagination on cursor. For Meta (default) leads are served from the persisted cache, ingested in real time from the leadgen webhook. When accountId is a LinkedIn ads account, leads are fetched live from LinkedIn's leadFormResponses (LinkedIn has no webhook and enforces 90-day retention, so nothing is persisted) and adAccountId is required. Reading LinkedIn responses needs the r_marketing_leadgen_automation permission; accounts connected before it was added must reconnect. Requires the Ads add-on.

get/v1/ads/leads

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/ads/leads
  • Auth: HTTP bearer

Query parameters

formIdstring

Filter to a single lead form.

accountIdstring

Filter to a single connected account. LinkedIn ads accounts switch to the live fetch.

adAccountIdstring

LinkedIn only: the LinkedIn ad account id whose responses to read (owner-scoped finder).

limitinteger
sinceinteger
Example:1757404800

Unix seconds; only leads created at/after this timestamp. Millisecond timestamps return 400 with instructions to divide by 1000.

cursorstring

Keyset cursor from a previous response's pagination.cursor (Meta: AdLead id; LinkedIn: numeric start offset).

Response

Lead list.

statusstring

Example response

{
  "status": "success"
}

Changes

  • c083c0fa652bRevision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • 567b13b62396Revision changes
    • info

      added the optional property to the response with the status