Add Subscriber Tags
Attach tags to a contact.
MethodPOST
/api/v2/subscribers/:subscriber/tagsAttaches tags to a contact. Missing tag names are created. Emits tag.added events. Permission: subscribers.
Path Parameters
| Name | Type | Description |
|---|---|---|
subscriber | string | Required. Subscriber id or email. |
Body Parameters
| Name | Type | Description |
|---|---|---|
tags | string[] | Required. Tag names to attach. |
Response Fields
| Field | Type | Description |
|---|---|---|
tagsAdded | integer | Number of tags processed. |
subscribersProcessed | integer | Contacts updated (always 1 on this route). |
totalAssociationsCreated | integer | New subscriber–tag links created. |
warning | string | Present when some ids were skipped. |
Errors
| Status | name | When |
|---|---|---|
| 401 | missing_api_key | Missing or invalid bearer token |
| 403 | missing_permission | Token lacks the subscribers permission |
| 404 | not_found | Unknown subscriber |
| 422 | validation_error | Invalid JSON body |