POST
/
lead-lists
{
  "id": "019440e0-3db3-7aa4-b32e-851d61c62d4c",
  "object": "lead_list",
  "name": "my list",
  "status": "queued",
  "shared": true,
  "visible": false,
  "owner": "foo-27@email.com",
  "type": "linkedin",
  "created_at": "2025-01-07T13:07:05Z",
  "updated_at": "2025-01-07T13:07:05Z",
  "options": {
    "reveal_phone_numbers": false,
    "validate_email": true,
    "enrich": true
  },
  "leads": [],
  "_links": {
    "self": {
      "href": "/lead-lists/019440e0-3db3-7aa4-b32e-851d61c62d4c"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Authorization
string
required
​
Content-Type
string
required

Query Parameters

​
page[size]
string

Page size

​
page[after]
string

Page after

​
page[before]
string

Page before

​
status
string

Filter by lead list status

​
owner_id
string

Filter by lead list owner id

​
owner_email
string

Filter by lead list owner email

Body

application/vnd.amp+json
​
leads
object[]
required

You may send up to 10000 leads at a time.

​
owner
string
required
​
shared
boolean
required
​
type
enum<string>
required
Available options:
linkedin,
email,
titles_and_company
​
name
string
​
options
object
​
visible
boolean

Response

202 - application/vnd.amp+json
​
_links
object
required
​
id
string
required
​
leads
object[]
required
​
name
string
required
​
object
enum<string>
required
Available options:
lead_list
​
owner
string
required
​
shared
boolean
required
​
status
enum<string>
required
Available options:
queued,
processing,
completed
​
type
enum<string>
required
Available options:
linkedin,
email,
title_and_company,
name_and_company,
salesforce,
hubspot,
person,
adaptive
​
visible
boolean
required
​
_errors
object[]
​
created_at
string
​
options
object
​
updated_at
string

Was this page helpful?

List Lead ListsRetrieve Lead List