---
title: "Add a label to a message"
method: PUT
path: "/addresses/{email}/messages/{messageId}/labels/{label}"
tags: ["Messages"]
---

# Add a label to a message

`PUT /addresses/{email}/messages/{messageId}/labels/{label}`

To help organize messages and group messages together, add a label to a message. Labels
are used in the Inbox UI to group messages.

When successful, returns 200 with a subset of the message object.

When the label already exists on the message, the message is not modified and the API
endpoint returns 200.

No PUT body is needed.

## Response `200`

Sets the specified label on a message.

- object
  - `_id` string, string — Unique Mailsac-generated identifier for an email message
  - `labels` MessageLabel[] — Labels for an email message

## Other responses

- `401` — Not authorized. You may need to log in first.

---

[API](https://skmtc.net/mailsac/apis/mailsac-api-specification.md) · [All operations](https://skmtc.net/mailsac/apis/mailsac-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mailsac/mailsac-api-specification/versions/5f8b55c76229/schema)