Create Tag

POST

/v1/tags

Create a new tag on a domain owned by the authenticated user. Either name/tagName and either domain/domainId are accepted for backward compatibility

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/jsonRequired

Example

{
    "name": "cold-outreach",
    "tagName": "cold-outreach",
    "domain": "b2bforcelabs.com",
    "domainId": "cmg9l788c0001la04ctg7t1j4",
    "tagColor": "#C6FF5A"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/tags' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "cold-outreach",
    "tagName": "cold-outreach",
    "domain": "b2bforcelabs.com",
    "domainId": "cmg9l788c0001la04ctg7t1j4",
    "tagColor": "#C6FF5A"
}'

Responses

🟢201

application/json

Tag created successfully

Bodyapplication/json

Example

{
    "status": 201,
    "message": "Tag created successfully.",
    "data": {
        "id": "tag_abc2",
        "tagName": "cold-outreach",
        "name": "cold-outreach",
        "domainId": "cmg9l788c0001la04ctg7t1j4",
        "createdAt": "2025-10-02T15:45:32.267Z"
    }
}

🟠400

🟠401

🟠404

🔴500

List Tags

Update Tag