List submitted leads
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.
Billing: Read (free unless it says otherwise) · Rate limit: 120/min
Request
- Base URL: https://apihub.co.il
- URL: https://apihub.co.il/v1/messaging/ads/leads
- Auth: HTTP bearer
Query parameters
Unix seconds; only leads created at/after this timestamp. Millisecond timestamps return 400 with instructions to divide by 1000.
Keyset cursor from a previous response's pagination.cursor (Meta: AdLead id; LinkedIn: numeric start offset).
Filter to a single lead form.
Filter to a single connected account. LinkedIn ads accounts switch to the live fetch.
LinkedIn only: the LinkedIn ad account id whose responses to read (owner-scoped finder).
Headers
Replay-safe: the same execution is returned instead of charging twice
Group calls into one job (e.g. one video) — see GET /v1/usage?tag=…
Response
Completed
Changes
No recorded changes to this operation across all 2 revisions of this API.