post /v2/exclusion-lists/items

Add items to exclusion list

Add people (LinkedIn handles) or companies (domains) to an exclusion list. Creates a new list when listId is omitted. Items are company domains in a companies list and LinkedIn handles in a people list. A URL is reduced to its domain or LinkedIn handle (https://www.linkedin.com/in/john-doe/ is stored as john-doe). Each request accepts up to 10,000 items. A list holds up to 300,000 items, or your plan's exclusion limit if it is lower. A request that would take the list past that limit returns a 400 and adds nothing.

Authorizations

apiToken string
x-api-token string

Body application/json

type enum Required
Whether the list holds people or companies.
"people""companies"
listId string
List to add items to. A new list is created when omitted.
Company domains or LinkedIn handles to add, up to 10,000 per request. Items are company domains in a companies list and LinkedIn handles in a people list. A URL is reduced to its domain or LinkedIn handle (`https://www.linkedin.com/in/john-doe/` is stored as `john-doe`).
Array of string

Responses

200 Successful Response
listId string Required
Unique id of the list.
400 Bad Request
detail enum Required
"Conflicting API tokens provided in query parameters and headers"
402 Payment Required
detail enum Required
"Insufficient email credits""Some email verifications are already in progress and might use all your remaining email credits. Please try again later.""Insufficient phone credits""Some phone verifications are already in progress and might use all your remaining phone credits. Please try again later.""Insufficient credits"
403 Forbidden
detail enum Required
"API token should be provided in headers or query parameters""Current API token is not registered in our database"
404 Not found
422 Validation Error
Array of ValidationError
Array of string | integer
string | integer
msg string Required
type string Required
input any
object
429 Too Many Requests
detail string Required