# POST /contacts/{id}/tags

Part of the SendHeron REST API. Base URL: `https://api.sendheron.com/api/v1`

Add tags to a contact, by id or by name.

```http
POST https://api.sendheron.com/api/v1/contacts/{id}/tags
Authorization: Bearer <YOUR_API_KEY>
```

**Required scopes:** `contacts:write`

**Success status:** `201`

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | uuid | yes | Contact UUID. |

**Body parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `tagIds` | uuid[] | no | Tags to attach by id. |
| `tagNames` | string[] | no | Tags to attach by name. |

> Adding a tag is what starts a tag-triggered sequence, so this doubles as the enrollment trigger.


---

Rate limits (global, all applied at once): 60 per minute, 150 per 5 minutes, 300 per hour, 2000 per day.