cURL
Entries
Add entries
Add up to 100 records to a list.
POST
cURL
Overview
The add entries method adds up to 100 records to a list in one request. Each record is identified either by its ID or bymatch criteria on the list’s
object. Both forms can be mixed in one request.
The request returns HTTP 200 whenever the body is valid, even if some records
could not be added. Each item in data reports the outcome for one record, in
request order:
No records are created. Re-adding a record that is already in the list has no
effect, so the request is safe to retry.
Examples
Add records by ID and by match
Add records by ID and by match
This adds one person by ID and one by email to a person list:
Usage
match works the same way as the request body of
find unique record. It must include
at least one unique attribute of the list’s object, such as email for a
person or domain for a company.
The request fails as a whole only when:
- The body is malformed, including a record listed twice or a
matchthat is not valid for the list’s object (HTTP 400) - The list does not exist (HTTP 404)
- The caller does not have manage access to the list (HTTP 403)
Authorizations
Path Parameters
ID of the list. String UUIDv4 value.
Body
application/json
Request body for adding records to a list.
Up to 100 record identifiers to add, processed in request order. ID and match identifiers may be mixed. Duplicate identifiers are not allowed.
Required array length:
1 - 100 elementsRecord identifier using an ID or attribute values.
- Option 1
- Option 2
Response
Response for adding records to a list.