Import contacts into a list

Adds 1 to 1,000 contacts to the list and returns what happened once the import is done. New addresses become
active contacts; addresses the account already has are added to the list and, with update_existing,
get the names and contact property values sent. Every contact gets the tags. The whole request is rejected
with 400 when any contact is invalid, so nothing is imported half way. Empty contact property values are ignored;
dates are stored as days.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int64
required
Body Params

The body of POST /v2/lists/{id}/import.

contacts
array of objects
required
length between 1 and 1000

1 to 1,000 contacts. The same email more than once (letter case aside) is imported once.

contacts*
string
required
length between 1 and 100
string | null
string | null
properties
array of objects | null

Values for the account's contact properties, written as in responses (numbers like 12.5, dates like 2026-10-21).

properties
tags
array of strings | null

Tag names added to every imported contact; tags the account does not have are created.

tags
boolean

When true, contacts that already exist get the names and contact property values sent. When false (the default),
they are only added to the list and keep their data.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json