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 a tag by ID

GET
/api/tags/{id}
Retrieve a tag by its unique ID
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.maildesk.io/api/tags/'
Response Response Example
{
    "tag": {
        "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
        "name": "Newsletter",
        "description": "Subscribers who opted in for the newsletter",
        "createdAt": "2024-03-20T15:30:00.000Z"
    }
}

Request

Path Params
id
string 
required

Responses

🟢200OK
application/json
Tag retrieved successfully
Body
tag
object 
required
Tag details
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
🟠401Unauthorized
Modified at 2025-06-28 19:47:25
Previous
Create a new tag
Next
Update a tag
Built with