Assign tags to domains or mailboxes

POST

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

Maintainer:Not configured

Bulk assign, remove, or set tags for multiple domains or mailboxes. Tags are workspace-specific and isolated.

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

🟢200OK

application/json

Tags assigned successfully

Body

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

cURL

Add tags to domainsRemove tags from mailboxesReplace all tagsCreate new tags and assign them

curl --location --request POST 'https://api.inboxkit.com/v1/api/tags/assign' \
--header 'X-Workspace-Id;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "entityType": "domains",
    "entityUids": [
        "550e8400-e29b-41d4-a716-446655440000"
    ],
    "tagUids": [
        "770e8400-e29b-41d4-a716-446655440002"
    ],
    "action": "add"
}'

Response Example

200 - Example 1

{
    "error": false,
    "message": "Tags added to 5 domains successfully",
    "data": {
        "entitiesUpdated": 5,
        "totalEntities": 5,
        "tags": [
            "string"
        ],
        "action": "add",
        "createdTags": [
            {
                "uid": "07cc67f4-45d6-494b-adac-09b5cbc7e2b5",
                "name": "string",
                "hexColor": "string"
            }
        ],
        "updatedEntities": [
            {
                "uid": "07cc67f4-45d6-494b-adac-09b5cbc7e2b5",
                "tags": [
                    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
                ]
            }
        ]
    }
}

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

List Consent Requests

Get all tags