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
| Method | Endpoint | Description |
|---|---|---|
| POST | /contacts | Create a new contact |
| GET | /contacts | List all contacts |
| GET | /contacts/{uuid} | Get a specific contact |
| PATCH | /contacts/{uuid} | Update a contact |
| DELETE | /contacts/{uuid} | Delete a contact |
Contact Object
| Field | Type | Description |
|---|---|---|
uuid | string | Unique identifier for the contact |
email | string | Contact's email address |
first_name | string|null | Contact's first name |
last_name | string|null | Contact's last name |
external_id | string|null | External identifier for integration purposes |
language | string|null | ISO 639-1 language code (2 characters) |
country_code | string|null | ISO 3166-1 alpha-2 country code (2 characters) |
created_at | string | ISO 8601 timestamp (UTC) |
updated_at | string | ISO 8601 timestamp (UTC) |