Campaigns

Import contacts from CSV

Import up to 5,000 rows (5 MB) per request. The header row needs an email column; name (or first_name and last_name), status, and tags (separated by ; or |) are recognized and other columns become custom fields. consent_basis is required and is recorded on every new contact. Optional tags are added to every accepted row. Rows whose status says unsubscribed import as unsubscribed. Existing contacts keep their status; set update_existing to merge names and fields. Duplicate rows are skipped and invalid rows are reported by line.

post/contact-imports

Request

Request body

csvstring required
list_idstring required
consent_basisstring required
tagsstring[] required
update_existingboolean required

Response

Successful response

idstring required
listIdstring required
consentBasisstring required
totalRowsinteger required
acceptedinteger required
createdinteger required
existinginteger required
skippedinteger required
invalidinteger required
tagsstring[] required
createdAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.