POST
/
lead-lists
curl --request POST \
  --url https://api.amplemarket.com/lead-lists \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '{
  "name": "<string>",
  "shared": true,
  "visible": true,
  "owner": "jsmith@example.com",
  "type": "linkedin",
  "options": {
    "reveal_phone_numbers": true,
    "validate_email": true,
    "enrich": true
  },
  "leads": [
    {
      "linkedin_url": "<string>",
      "email": "jsmith@example.com",
      "title": "<string>",
      "company_name": "<string>",
      "company_domain": "<string>"
    }
  ]
}'
{
  "id": "01952828-eae3-743b-a323-5c3ea1fc7d5f",
  "object": "lead_list",
  "name": "my list",
  "status": "queued",
  "shared": true,
  "visible": false,
  "owner": "admin@example.com",
  "type": "linkedin",
  "created_at": "2025-02-21T10:58:45Z",
  "updated_at": "2025-02-21T10:58:45Z",
  "options": {
    "reveal_phone_numbers": false,
    "validate_email": true,
    "enrich": true
  },
  "leads": [],
  "_links": {
    "self": {
      "href": "/lead-lists/01952828-eae3-743b-a323-5c3ea1fc7d5f"
    }
  }
}

Authorizations

​
Authorization
string
header
required

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

Headers

​
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 to create the list with
​
shared
boolean
required
​
owner
string
required
​
type
enum<string>
required
Available options:
linkedin,
email,
titles_and_company
​
leads
object[]
required

You may send up to 10000 leads at a time.

​
name
string
​
visible
boolean
​
options
object

Response

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

Was this page helpful?

List Lead ListsRetrieve Lead List