Create or find tags

Create tags in a profile.

Create or find tags

post

Create tags in a profile.

Names that already exist in the profile are not duplicated: the existing tag is returned instead, so the call is safe to repeat. Every tag in the request is returned, whether it was created now or already existed.

Authorizations

AuthorizationstringRequired

API Token authentication

Path parameters

profileUuidstringRequired

Profile uuid parameter

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

Body

Names to create. Names that already exist in the profile are returned as they are.

namesstring[] · min: 1 · max: 100RequiredExample: ["Newsletter","VIP","Promo"]

Responses

200

Success response

application/json

Array of Reach.V1.Contacts.Tags.TagResource

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

422

Validation error response

application/json

500

Error response

application/json

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

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

{
  "names": [
    "Newsletter",
    "VIP",
    "Promo"
  ]
}

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