POST
/
lead-lists
/
{id}
/
leads
Add Leads to a List
curl --request POST \
  --url https://api.amplemarket.com/lead-lists/{id}/leads \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "linkedin",
  "leads": [
    {
      "linkedin_url": "<string>",
      "email": "jsmith@example.com",
      "title": "<string>",
      "company_name": "<string>",
      "company_domain": "<string>"
    }
  ]
}'
{
"total": 1,
"total_added_to_lead_list": 1
}

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Lead List id

Body

application/json

Leads to add to the list

leads
object[]
required

You can add up to 10,000 leads at a time. However, each Lead List can have a maximum of 60,000 leads. When approaching this limit, new leads will be added partially until the limit is reached. When the limit is hit, a 409 HTTP status code will be returned. Enriching, email validation, and reveal settings are inherited from the Lead List settings. If credits are spent, those will be deducted from the admin user of the account.

Maximum length: 10000
type
enum<string>
Available options:
linkedin,
email,
titles_and_company

Response

Lead List Leads accepted

total
integer

Total number of leads processed in the request.

total_added_to_lead_list
integer

Total number of leads successfully added to the lead list.