Sign in

v58

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-073053701.0 MB
Reach: Contacts

Create contacts in bulk

Create many contacts in a profile in a single call.

The contacts are imported in the background, so a success response means the import was accepted rather than finished. Contacts whose email already exists in the profile are left as they are. If double opt-in is enabled, new contacts start off pending and are sent a confirmation email.

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

Path parameters

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

Profile uuid parameter

Request body

tag_uuidsstring[]

Existing tags to attach to every created contact

notestring nullable

Note applied to every created contact

Example request

{
  "contacts": [
    {
      "email": "john.doe@example.com",
      "name": "John",
      "surname": "Doe",
      "phone": "+14155552671"
    }
  ],
  "note": "Imported from CRM"
}

Response

Success empty response

messagestring

Example response

{
  "message": "Request accepted"
}