Wawp WhatsApp API
HomePricing
HomePricing
WhatsApp
API Status
  1. ๐Ÿท๏ธ Labels
  • โ›“๏ธโ€๐Ÿ’ฅ Session - instances
    • Wawpโ€™s Session Lifecycle
    • Create new Session
      POST
    • Start Session
      POST
    • Stop Session
      POST
    • Restart Session
      POST
    • Delete Session
      DELETE
    • Logout Session
      POST
    • Get Session info
      GET
    • About WhatsApp Data
      GET
  • ๐Ÿ“ฒ Authentication - Login
    • About login authentication
    • GET QR raw
      GET
    • GET QR image
      GET
    • Request code
      POST
    • Get a live screenshot
      GET
  • ๐Ÿ“ค Send Messages
    • Send Messages
    • Send Text
    • Send Image
    • Send PDF
    • Send Voice
    • Send video
    • Send Link Preview
    • Send Location
    • Send poll
    • Send Contact Vcard
    • Mark message(s) as seen
    • Start typing
    • Stop typing
    • Reaction
    • Star/unstar a message
  • โ„น๏ธ Whatsapp Profile info
    • WhatsApp Profile Info
    • Get profile
    • Set displayโ€‘name
    • Set โ€œAboutโ€ status
    • Upload Whatsapp picture
    • Delete profile picture
  • ๐Ÿ“ข Channels Control
    • Get list of know channels
    • Create a new channel.
    • Get channel info
    • Delete channel
    • Preview channel messages
    • Follow a channel
    • Unfollow a channel
    • Mute a channel
    • Unmute a channel
    • Search channels โ€” by view
    • Search channels โ€” by text
    • Search metadata โ€” views / countries / categories
  • ๐ŸŸข Presence information
    • Presence API
    • Set session presence
    • Get the presence for the chat id
  • ๐Ÿ”Š 24 Hour Status
    • Text status
    • Image status
    • Voice status
    • Video status
    • Delete status
  • ๐Ÿ’ฌ Chats
    • Chats list & overview
    • chats overview
    • chats overview
    • Delete the chat
    • Get chat picture
    • Get messages in the chat.
    • Clear all messages from the chat.
    • Mark unread messages as read.
    • Get message by id
    • Delete a message
    • Edit a text message
    • Pin a message
    • Unpin a message
    • Archive the chat
    • Unarchive the chat
    • Mark chat as unread
  • ๐Ÿชช Contacts
    • Get all contacts
    • Get basic contact info
    • Check phone is on WhatsApp
    • Get contact โ€œaboutโ€
    • Get contact profile picture (24h cache; add refresh=true to bust)
    • Block contact
    • Unblock contact
    • Create/Update contact on phone address book
    • Get all known lids to phone number mapping
    • Get the number of known lids
  • ๐Ÿ‘ฅ Groups
    • Get All List groups
    • Create a group
    • Join info (by code or URL)
    • Join group
    • Get the number of groups
    • Refresh groups from the server
    • Get the group
    • Delete the group
    • Leave the group
    • Get group picture
    • Set group picture
    • Delete group picture
    • Updates the group description
    • Updates the group subject
    • Updates the group "info admin only" settings
    • Update settings - who can send messages
    • Get settings - who can send messages
    • Set messages admin only
    • Get the invite code for the group
    • Invalidates the current group invite code and generates a new one
    • Get participants
    • Add participants
    • Remove participants
    • Promote participants to admin users
    • Demotes participants to regular users
  • ๐Ÿท๏ธ Labels
    • Labels API
    • GET all labels
      GET
    • Create label
      POST
    • Update label
      PUT
    • DELETE label
      DELETE
    • labels for a chat
      GET
    • Save labels for a chat
      PUT
    • Chats with a label
      GET
  • ๐Ÿช Webhooks
    • Wawpโ€™s Webhook API
    • session.status
    • message
    • message.reaction
    • message.any
    • message.ack
    • message.revoked
    • message.edited
    • group.v2.join
    • group.v2.leave
    • group.v2.update
    • group.v2.participants
    • presence.update
    • poll.vote.failed
    • chat.archive
    • call.received
    • call.accepted
    • call.rejected
    • label.upsert
    • label.deleted
    • label.chat.added
    • label.chat.deleted
    • event.response
    • event.response.failed
    • engine.event
  1. ๐Ÿท๏ธ Labels

Labels API

You can work with WhatsApp Labels available in WhatsApp Business using the API.
Labels help you organize chats and contacts for faster workflows.
The-Ultimate-Guide-to-Level-Up-Change-from-WhatsApp-to-WhatsApp-Business-Account-โ€“-7-1024x512.png

โœจ Features by Engine#

๐Ÿท๏ธ Labels - API โ†’ Create, update, list, and delete labels.
๐Ÿท๏ธ Labels - Events โ†’ Receive webhook events when labels are added or removed.

๐ŸŽจ Label Colors#

Each label has two color-related fields in the body and response:
color โ†’ internal color number (0โ€“19)
colorHex โ†’ latest known hex color for the label
โš ๏ธ Important: The color โ†” colorHex map may change, so always rely on the color number when creating or updating labels.

๐Ÿ“‹ Current Color Map#

ColorHex CodeExample Meaning
0#ff9485๐Ÿ”ด Urgent / Needs Attention
1#64c4ff๐Ÿ”ต New Lead / To Follow Up
2#ffd429๐ŸŸก Pending / Waiting Response
3#dfaef0๐Ÿ’œ Personal / Soft Priority
4#99b6c1โšช Neutral / Archived
5#55ccb3๐ŸŸข Payment / Finance
6#ff9dff๐ŸŒธ Marketing / Campaign
7#d3a91d๐Ÿ… VIP / High Value
8#6d7cce๐ŸŸฃ Internal / Team Use
9#d7e752โœ… Success / Completed
10#00d0e2๐Ÿ› ๏ธ Technical Support
11#ffc5c7๐Ÿ’Œ Personal Chat
12#93ceac๐ŸŒฑ Onboarding / New Customer
13#f74848๐Ÿšจ Escalation / Critical
14#00a0f2๐Ÿ“˜ Active Conversation
15#83e422โœ”๏ธ Confirmed / Approved
16#ffaf04โฐ Reminder / To-Do
17#b5ebff๐ŸงŠ Cold Lead / Info Only
18#9ba6ff๐Ÿ”ฎ Low Priority
19#9368cf๐Ÿ—‚๏ธ Custom Tag / Other

๐Ÿ“ฆ Example Label Object#

{
  "id": "2",
  "name": "Favorites",
  "color": 1,
  "colorHex": "#64c4ff"
}
Modified atย 2025-09-29 02:28:40
Previous
Demotes participants to regular users
Next
GET all labels
Built with