Assign a contact to a tag

Assign a tag to a single contact. Unlike the bulk endpoint this is applied immediately rather than queued. Assigning a tag the contact already carries succeeds without duplicating it.

Assign a contact to a tag

post

Assign a tag to a single contact.

Unlike the bulk endpoint this is applied immediately rather than queued. Assigning a tag the contact already carries succeeds without duplicating it.

Authorizations

AuthorizationstringRequired

API Token authentication

Path parameters

profileUuidstringRequired

Profile uuid parameter

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

tagUuidstring · uuidRequired

Tag uuid parameter

Example: 550e8400-e29b-41d4-a716-446655440000

contactUuidstring · uuidRequired

Contact uuid parameter

Example: 550e8400-e29b-41d4-a716-446655440000

Responses

200

Success response

application/json

uuidstringOptionalExample: 550e8400-e29b-41d4-a716-446655440000

typestring · enumOptional

How the tag came about. custom covers the tags you create yourself, form covers the ones Reach creates for its forms.

Example: customPossible values:

valuestringOptionalExample: Newsletter

created_atstring · date-timeOptionalExample: 2025-02-27T11:54:22Z

401

Unauthenticated response

application/json

500

Error response

application/json

post/api/reach/v1/profiles/{profileUuid}/tags/{tagUuid}/contacts/{contactUuid}

POST /api/reach/v1/profiles/{profileUuid}/tags/{tagUuid}/contacts/{contactUuid} HTTP/1.1
Host: developers.hostinger.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "type": "custom",
  "value": "Newsletter",
  "created_at": "2025-02-27T11:54:22Z"
}