v51

OpenAPI 3.0.0raw.githubusercontent.com2026-08-01267339950.6 KB
Reach: Contacts

Create new contacts

Create a new contact in the email marketing system.

This endpoint allows you to create a new contact with basic information like name, email, and surname.

If double opt-in is enabled, the contact will be created with a pending status and a confirmation email will be sent.

post/api/reach/v1/profiles/{profileUuid}/contacts

Path parameters

profileUuidstring required
Example:550e8400-e09b-41d4-a716-400055000000

Profile uuid parameter

Request body

emailstring required
namestring nullable
surnamestring nullable
phonestring nullable

Phone number in E.164 format (leading "+" then 7-15 digits)

notestring nullable

Example request

{
  "email": "john.doe@example.com",
  "name": "John",
  "surname": "Doe",
  "phone": "+14155552671",
  "note": "VIP customer"
}

Response

Success empty response

messagestring

Example response

{
  "message": "Request accepted"
}