Skip to main content
POST
/
api
/
v1
/
contacts
curl -X POST https://app.demeterrr.com/api/v1/contacts \
  -H "X-API-Key: dem_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "jane.smith@example.com",
    "firstName": "Jane",
    "lastName": "Smith",
    "phone": "+15559876543",
    "preferredLanguage": "en",
    "tags": ["new-customer"]
  }'

{
  "data": {
    "id": "770e8400-e29b-41d4-a716-446655440000",
    "email": "jane.smith@example.com",
    "firstName": "Jane",
    "lastName": "Smith",
    "phone": "+15559876543",
    "title": null,
    "preferredLanguage": "en",
    "locationId": null,
    "contactOrganizationId": null,
    "customFields": {},
    "tags": ["new-customer"],
    "unsubscribed": false,
    "createdAt": "2026-02-10T15:30:00.000Z",
    "updatedAt": "2026-02-10T15:30:00.000Z"
  }
}

​
Authentication

Requires contacts:write scope.

​
Request Body

​
email
string
required
Contact’s email address (must be valid)
​
firstName
string
required
Contact’s first name
​
lastName
string
Contact’s last name
​
phone
string
Phone number (E.164 format recommended, e.g., +15551234567)
​
title
string
Job title or salutation (e.g., “Mr.”, “Dr.”, “CEO”)
​
preferredLanguage
string
Preferred language: en or fr
​
locationId
string
UUID of associated location
​
contactOrganizationId
string
UUID of associated organization
​
customFields
object
Custom field values as key-value pairs
​
tags
array
Array of tag strings

​
Response

Returns the created contact object. 
curl -X POST https://app.demeterrr.com/api/v1/contacts \
  -H "X-API-Key: dem_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "jane.smith@example.com",
    "firstName": "Jane",
    "lastName": "Smith",
    "phone": "+15559876543",
    "preferredLanguage": "en",
    "tags": ["new-customer"]
  }'

{
  "data": {
    "id": "770e8400-e29b-41d4-a716-446655440000",
    "email": "jane.smith@example.com",
    "firstName": "Jane",
    "lastName": "Smith",
    "phone": "+15559876543",
    "title": null,
    "preferredLanguage": "en",
    "locationId": null,
    "contactOrganizationId": null,
    "customFields": {},
    "tags": ["new-customer"],
    "unsubscribed": false,
    "createdAt": "2026-02-10T15:30:00.000Z",
    "updatedAt": "2026-02-10T15:30:00.000Z"
  }
}