Skip to main content

Contacts

Contacts are the people in your email lists. The Contacts API allows you to create, retrieve, update, and delete contacts in your easymail account.

Overview

Each contact has a unique email address and can include additional information like name, language preference, and custom fields. Contacts can be added to one or more lists for targeted email campaigns.

Endpoints

MethodEndpointDescription
POST/contactsCreate a new contact
GET/contactsList all contacts
GET/contacts/{uuid}Get a specific contact
PATCH/contacts/{uuid}Update a contact
DELETE/contacts/{uuid}Delete a contact

Contact Object

FieldTypeDescription
uuidstringUnique identifier for the contact
emailstringContact's email address
first_namestring|nullContact's first name
last_namestring|nullContact's last name
external_idstring|nullExternal identifier for integration purposes
languagestring|nullISO 639-1 language code (2 characters)
country_codestring|nullISO 3166-1 alpha-2 country code (2 characters)
created_atstringISO 8601 timestamp (UTC)
updated_atstringISO 8601 timestamp (UTC)