Create Contact

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

Create a new contact

post

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

anyOptional

or

anyOptional

Responses

201

Contact created

application/json

idstring · uuidOptional

first_namestring · nullableOptional

last_namestring · nullableOptional

emailstring · email · nullableOptional

phone_numberstring · nullableOptional

date_of_birthstring · date · nullableOptional

email_consentbooleanOptionalDefault: false

sms_consentbooleanOptionalDefault: false

whatsapp_consentbooleanOptionalDefault: false

created_atstring · date-timeOptional

updated_atstring · date-timeOptional

422

Validation error

application/json

post

/contacts

HTTPcURLJavaScriptPython

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

{
  "first_name": "text",
  "last_name": "text",
  "email": "[e-mail]",
  "phone_number": "text",
  "date_of_birth": "2026-03-21",
  "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": "2026-03-21",
  "email_consent": false,
  "sms_consent": false,
  "whatsapp_consent": false,
  "created_at": "2026-03-21T22:26:51.261Z",
  "updated_at": "2026-03-21T22:26:51.261Z"
}