Add a label to a contact
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 POST 'https://api.whatsable.app/v1/contacts/string/labels' \
-H 'Content-Type: application/json' \
-d '{
"label": "VIP"
}'Adds a label to a contact. If the contact already has the label, nothing changes and the answer is 200.
bearerAuthAuthorizationBearer <nfy_live_<32 characters>>An API key from Settings > API keys, sent as Authorization: Bearer <key>.
id*stringThe contact id.
1 <= length <= 64application/json- body
The label to add to the contact.
label*stringA label id, or a label's exact name (compared ignoring case and accents). An unknown label is a 404; none is created.
1 <= length <= 128The contact with its labels.
application/json- response
A person the organization talks to on WhatsApp.
object*stringid*string1 <= length <= 64phone*|Null when WhatsApp withheld the number and only a user id is known.
wa_user_id*|The Business-Scoped User ID, when WhatsApp gave one.
username*|The WhatsApp username, without @.
name*string|nullnote*|The contact's note, as the inbox shows it.
automation_note*|A note kept for automations, separate from note.
labels*array<>conversations*array<>One per number the person has talked to, among the numbers this key may use.
follow_ups*stringThe inbox's Follow up switch. off: the AI never follows up with this person, on any number, until it is switched back on. on does not mean a follow-up is coming: that also depends on the bot's follow-up settings and the conversation's AI status.
"on""off"created_at*stringdate-timeupdated_at*stringdate-timecurl -X POST 'https://api.whatsable.app/v1/contacts/string/labels' \ -H 'Content-Type: application/json' \ -d '{ "label": "VIP"}'{ "object": "contact", "id": "cm2v8k1a00001qz8h8x9y0z1a", "phone": "+5491155550000", "wa_user_id": null, "username": null, "name": "Ana Pérez", "note": null, "automation_note": null, "labels": [ { "id": "cm2v8l1a00001qz8h2b3c4d5e", "name": "VIP" } ], "conversations": [ { "id": "cm2v8c1a00001qz8h4t5u6v7w", "number_id": "cm2v8a1b20002qz8h9i0j1k2l" } ], "follow_ups": "on", "created_at": "2026-09-01T12:00:00Z", "updated_at": "2026-10-20T19:51:21Z"}