Maildesk API
  1. Tags
Maildesk API
  • Subscribers
    • Get a subscriber by ID
      GET
    • Update a subscriber
      PUT
    • Delete a subscriber
      DELETE
    • Get all subscribers
      GET
    • Create a new subscriber
      POST
  • Tags
    • Get all tags
      GET
    • Create a new tag
      POST
    • Get a tag by ID
      GET
    • Update a tag
      PUT
    • Delete a tag
      DELETE
  1. Tags

Get all tags

GET
/api/tags
Retrieve all tags for the authenticated user
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.maildesk.io/api/tags'
Response Response Example
{
    "tags": [
        {
            "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
            "name": "Newsletter",
            "description": "Subscribers who opted in for the newsletter",
            "createdAt": "2024-03-20T15:30:00.000Z"
        }
    ],
    "total": 100,
    "page": 1,
    "limit": 10
}

Request

None

Responses

🟢200OK
application/json
Tags retrieved successfully
Body
tags
array[object (TagResponse) {4}] 
required
Array of tags
id
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
total
number 
required
Total number of tags
Example:
100
page
number 
required
Current page number
Example:
1
limit
number 
required
Number of items per page
Example:
10
🟠401Unauthorized
Modified at 2025-06-28 19:47:25
Previous
Create a new subscriber
Next
Create a new tag
Built with