Lists
POST
/lists/{id}/leads

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.

Authorization

bearerAuth
AuthorizationBearer <token>

An API key created under Settings → API & Webhooks.

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/lists/string/leads" \  -H "Content-Type: application/json" \  -d '{    "leads": [      {        "profileUrl": "https://www.linkedin.com/in/jane-doe",        "firstName": "Jane",        "lastName": "Doe",        "company": "Acme"      },      {        "profileUrl": "https://www.linkedin.com/in/john-roe",        "email": "john@roe.dev"      }    ]  }'
{  "data": {    "inserted": 0,    "skipped": 0  }}