Back to Dashboard
API Discovery
Back to Tools

update_customer_tags

write:customers

Add or remove tags from a customer. Tags help categorize and segment customers (e.g., 'vip', 'new-client', 'prefers-morning').

Input Parameters

Parameters

PropertyTypeDescription
customerIdrequiredstringCustomer UUID
addTagsstring[]Tags to add (each: 1-50 chars)
removeTagsstring[]Tags to remove

Response

Response Schema

PropertyTypeDescription
customerIdrequiredstringCustomer UUID
currentTagsrequiredstring[]All tags after update
tagsAddedrequiredstring[]Tags that were added
tagsRemovedrequiredstring[]Tags that were removed

Example

Requestjson
{
  "type": "tool",
  "name": "update_customer_tags",
  "params": {
    "customerId": "customer-uuid",
    "addTags": ["vip", "prefers-morning"],
    "removeTags": ["new-client"]
  }
}
Responsejson
{
  "success": true,
  "data": {
    "customerId": "customer-uuid",
    "currentTags": ["vip", "prefers-morning", "loyal"],
    "tagsAdded": ["vip", "prefers-morning"],
    "tagsRemoved": ["new-client"]
  }
}

cURL Example

curl -X POST https://app.bizily.io/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{\n  "type": "tool",\n  "name": "update_customer_tags",\n  "params": {\n    "customerId": "customer-uuid",\n    "addTags": ["vip", "prefers-morning"],\n    "removeTags": ["new-client"]\n  }\n}'

Required scope: This tool requires the write:customers scope. Make sure your API key has this permission enabled in Settings → Developer.