Rename or change a label
Build a request to copy
This page never sends a request. Fill in the fields, then copy the request and run it from your server.
curl -X PATCH 'https://api.whatsable.app/v1/labels/string' \
-H 'Content-Type: application/json' \
-d '{
"name": "Gold"
}'Changes a label. A label limited to some numbers can be changed only by a key that may use all of them. An empty number_ids makes the label available on every number, so it needs a key that may use every number.
bearerAuthAuthorizationBearer <nfy_live_<32 characters>>An API key from Settings > API keys, sent as Authorization: Bearer <key>.
id*stringThe label id.
1 <= length <= 64application/json- body
The fields to change. Fields left out are kept.
name?string1 <= length <= 60color?string"label-1""label-2""label-3""label-4""label-5""label-6"description?|nullkeywords?array<>items <= 20number_ids?array<>Limit the label to these numbers. Empty or absent means every number.
items <= 50The updated label.
application/json- response
A label the organization tags contacts with.
object*stringid*string1 <= length <= 64name*stringcolor*stringOne of six palette slots the dashboard draws.
"label-1""label-2""label-3""label-4""label-5""label-6"description*string|nullkeywords*array<string>Words that apply the label automatically to an inbound message, stored normalized.
number_ids*array<>The numbers the label is limited to. Empty means every number.
created_at*stringdate-timeupdated_at*stringdate-timecurl -X PATCH 'https://api.whatsable.app/v1/labels/string' \ -H 'Content-Type: application/json' \ -d '{ "name": "Gold"}'{ "object": "label", "id": "cm2v8l1a00001qz8h2b3c4d5e", "name": "VIP", "color": "label-2", "description": "Customers with more than five orders", "keywords": [ "vip" ], "number_ids": [], "created_at": "2026-09-01T12:00:00Z", "updated_at": "2026-09-01T12:00:00Z"}