Create Note

Add a note to a customer chat or a WhatsApp group chat.

Before you call

  • note is required.
  • For a customer chat, send to (customer number) and from (your WhatsApp number), both with country code.
  • For a WhatsApp group chat, send groupId instead.
  • entities is optional: users or teams to mention, each with entityType (USER or TEAM) and entityId.

How it works

  • If the customer or the chat does not exist yet, it is created.
  • Mentioned users and teams are notified.
  • A note-created webhook event is sent.
  • The response is the created note. Use its id with Get Note, Update Note and Delete Note.
  • Returns 404 if from is not one of your WhatsApp numbers.

Rate limit

  • 60 requests per minute.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Text content of the note

string

The groupId of the WA Group. Use this instead of to/from when creating a note for a group chat.

string
length between 10 and 15

The WABA phone number with country code. Required when not using groupId.

string
length between 10 and 15

The customer phone number with country code. Required when not using groupId.

entities
array of objects

Optional entities (e.g., users) mentioned in the note that should receive notifications

entities
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json