POST

Create Contact Tag

Creates a new contact tag in the specified sub-account.

POSThttps://api.vantaxai.com/v1/contact-tags

Tag names are unique within a sub-account (case-insensitive). Once created, a tag can be applied to contacts via Create or Update Contact.

Headers

Authorizationstringrequired
Bearer authentication with your secret API key.
example: Bearer vx_live_3fa9c2…
Content-Typestringrequired
Must be application/json for requests with a body.
example: application/json

Body Parameters

namestringrequired
Tag name (max 64 characters).
example: vip
sub_account_idstringrequired
Sub-account that will own the tag.
example: sub_8a1f4c2e
colorstringoptional
Display color as a hex code.
example: #7C3AED

Request

curl -X POST https://api.vantaxai.com/v1/contact-tags \
  -H "Authorization: Bearer vx_live_3fa9c2..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "vip",
  "sub_account_id": "sub_8a1f4c2e",
  "color": "#7C3AED"
}'

const res = await fetch(
  "https://api.vantaxai.com/v1/contact-tags",
  {
  method: "POST",
  headers: {
    Authorization: "Bearer vx_live_3fa9c2...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "name": "vip",
    "sub_account_id": "sub_8a1f4c2e",
    "color": "#7C3AED"
  }),
  }
);
const { data } = await res.json();

import { Vantax } from "@vantax/sdk";

const vantax = new Vantax({ apiKey: process.env.VANTAX_API_KEY! });
// POST /v1/contact-tags
const result = await vantax.request("POST", "/v1/contact-tags", {
  "name": "vip",
  "sub_account_id": "sub_8a1f4c2e",
  "color": "#7C3AED"
});

from vantax import Vantax

vantax = Vantax(api_key=os.environ["VANTAX_API_KEY"])
# POST /v1/contact-tags
result = vantax.request("POST", "/v1/contact-tags", json={"name": "vip", "sub_account_id": "sub_8a1f4c2e", "color": "#7C3AED"})

Response

{
  "success": true,
  "message": "Contact tag created successfully",
  "data": {
    "id": "tag_4f17a2",
    "name": "vip",
    "color": "#7C3AED",
    "created_at": "2026-01-10T09:00:00Z"
  }
}

{
  "success": false,
  "message": "Validation failed",
  "errors": [
    { "field": "name", "message": "name is required" }
  ]
}