Create contacts in bulk

Create many contacts in a profile in a single call.

Create contacts in bulk

post

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.

Authorizations

AuthorizationstringRequired

API Token authentication

Path parameters

profileUuidstringRequired

Profile uuid parameter

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

Body

Create many contacts in one call

tag_uuidsstring[]Optional

Existing tags to attach to every created contact

notestring · max: 75 · nullableOptional

Note applied to every created contact

Example: Imported from CRM

Responses

200

Success empty response

application/json

messagestringOptionalExample: Request accepted

401

Unauthenticated response

application/json

422

Validation error response

application/json

500

Error response

application/json

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

POST /api/reach/v1/profiles/{profileUuid}/contacts/bulk HTTP/1.1
Host: developers.hostinger.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 148

{
  "contacts": [
    {
      "email": "[e-mail]",
      "name": "John",
      "surname": "Doe",
      "phone": "[phone]"
    }
  ],
  "tag_uuids": [
    "text"
  ],
  "note": "Imported from CRM"
}

{
  "message": "Request accepted"
}