Contacts
Create Contact
Create a new contact.
POST /api/v1/contacts
Create a new contact. Returns 409 if a contact with the same email already exists for your account.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
email | string | Yes | Email address |
phone | string | No | Phone number (min 3 characters) |
firstName | string | No | First name |
lastName | string | No | Last name |
tags | string[] | No | Array of tag strings |
customFields | object | No | Key-value pairs for custom data |
emailSubscriptionStatus | "subscribed" | "unsubscribed" | No | Defaults to "subscribed" |
whatsappSubscriptionStatus | "subscribed" | "unsubscribed" | No | Defaults to "subscribed" |
Example
curl -X POST /api/v1/contacts \
-H "x-api-key: mndr_..." \
-H "Content-Type: application/json" \
-d '{
"email": "jane@example.com",
"firstName": "Jane",
"lastName": "Smith",
"tags": ["customer", "vip"]
}'{
"contact": {
"id": "uuid",
"email": "jane@example.com",
"firstName": "Jane",
"lastName": "Smith",
"tags": ["customer", "vip"],
"emailSubscriptionStatus": "subscribed",
"whatsappSubscriptionStatus": "subscribed",
"customFields": {},
"createdAt": "2026-03-23T12:00:00.000Z",
"updatedAt": "2026-03-23T12:00:00.000Z"
}
}