Create Contact

Creates a new contact with basic information and consent settings. Requires either email or phone number.

Create a new contact

post

Authorizations

Body

first_namestringOptional

last_namestringOptional

emailstring · emailOptional

phone_numberstringOptional

date_of_birthstring · dateOptional

email_consentbooleanOptional

sms_consentbooleanOptional

whatsapp_consentbooleanOptional

Responses

201

Contact created

application/json

422

Validation error

application/json

post

HTTPcURLJavaScriptPython

POST /api/v1/contacts HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 180

{
  "first_name": "text",
  "last_name": "text",
  "email": "[e-mail]",
  "phone_number": "text",
  "date_of_birth": "2025-09-01",
  "email_consent": true,
  "sms_consent": true,
  "whatsapp_consent": true
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "first_name": "text",
  "last_name": "text",
  "email": "[e-mail]",
  "phone_number": "text",
  "date_of_birth": "2025-09-01",
  "email_consent": false,
  "sms_consent": false,
  "whatsapp_consent": false,
  "created_at": "2025-09-01T02:01:31.955Z",
  "updated_at": "2025-09-01T02:01:31.955Z"
}