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

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-02-03",
  "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-02-03",
  "email_consent": false,
  "sms_consent": false,
  "whatsapp_consent": false,
  "created_at": "2026-02-03T11:24:43.583Z",
  "updated_at": "2026-02-03T11:24:43.583Z"
}