Create a new tag

POST

https://api.inboxkit.com/v1/api/tags

Maintainer:Not configured

Create a new tag for the workspace. Tag names can be duplicated across workspaces but each will have a unique UID.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Tag created successfully

Body

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🟠409409

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

cURL

Create tag with default colorCreate tag with custom color

curl --location --request POST 'https://api.inboxkit.com/v1/api/tags' \
--header 'X-Workspace-Id;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Important"
}'

Response Example

201 - Example 1

{
    "error": false,
    "message": "Tag created successfully",
    "tag": {
        "uid": "770e8400-e29b-41d4-a716-446655440002",
        "name": "Production",
        "hexColor": "#FF5733",
        "usageCount": 15,
        "usedBy": {
            "domains": 10,
            "mailboxes": 5
        },
        "createdAt": "2025-01-01T00:00:00.000Z",
        "updatedAt": "2025-01-15T12:30:00.000Z"
    }
}

Modified at 2025-09-16 07:47:25

Get all tags

Delete a tag