Lists
Authorization
bearerAuth AuthorizationBearer <token>
An API key created under Settings → API & Webhooks.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/lists" \ -H "Content-Type: application/json" \ -d '{ "name": "Conference leads" }'{ "data": { "id": "string", "name": "string", "color": "string", "leadCount": 0, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" }}Add leads to a list POST
Upserts the workspace leads from the `{ profileUrl, ... }` objects you pass and attaches them to this list in one call — you don't need to create leads separately first. Existing leads are matched on their LinkedIn identifier and updated with any new fields. Max 1000 leads per request.
Delete a lead list DELETE
Deletes the list. The leads in it are kept; only their membership is removed.