v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
Lead Gen

List submitted leads

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

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

Unix seconds; only leads created at/after this timestamp.

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"
}