Skip to main content
GET
List Lead Lists
A list owns leads. listId is what you pass to POST /api/leads to file new leads somewhere specific, and to POST /api/leads/check-availability to check a whole list at once. These endpoints are how you get a listId without opening the dashboard.
Returns every list in the workspace, newest first. No query parameters.

Authentication

Pass your workspace API key as a Bearer token, or use a Clerk session token.

Example

Success (200 OK)

The Quick Sends list is created on the first call if it does not exist, so this endpoint never returns an empty array. Quick Sends is where leads go when you send to a phone number that has no saved lead yet, and when you omit listId on POST /api/leads.

Response

object[]
Every list in the workspace, newest first.

Errors