Create a new tag

POST

/api/tags

Create a new tag with the provided details

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.maildesk.io/api/tags' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Newsletter Subscribers",
    "description": "Subscribers who signed up for the newsletter"
}'

Response Example

{
    "tag": {
        "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
        "name": "Newsletter",
        "description": "Subscribers who opted in for the newsletter",
        "createdAt": "2024-03-20T15:30:00.000Z"
    }
}

Request

Body Params application/json

name

string

required

The name of the tag

Example:

Newsletter Subscribers

description

string

optional

Optional description for the tag

Example:

Subscribers who signed up for the newsletter

Examples

Responses

🟢201Created

application/json

Tag created successfully

Body

tag

object

required

Tag details

string

required

Unique identifier of the tag (ULID)

Example:

01ARZ3NDEKTSV4RRFFQ69G5FAV

name

string

required

Name of the tag

Example:

Newsletter

description

string

optional

Optional description of the tag

Example:

Subscribers who opted in for the newsletter

createdAt

string

required

Creation timestamp of the tag

Example:

2024-03-20T15:30:00.000Z

🟠401Unauthorized

Modified at 2025-06-28 19:47:25

Get all tags

Get a tag by ID