WhatsAble
Get Started
GuidesAPI Reference
API v1Conversations

Add an internal note to a conversation

posthttps://api.whatsable.app/v1/conversations/{id}/notes
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.

Request
curl -X POST 'https://api.whatsable.app/v1/conversations/string/notes' \
  -H 'Content-Type: application/json' \
  -d '{
  "body": "Asked for the invoice again; call back Monday."
}'

Adds an internal note to the conversation. The team sees it in the inbox, under this key's name; the customer never does, and nothing is sent to WhatsApp. Read the notes with GET /v1/conversations/{id}/timeline?types=note.

Authorization

bearerAuth
headerAuthorizationBearer <nfy_live_<32 characters>>

An API key from Settings > API keys, sent as Authorization: Bearer <key>.

Path Parameters

id*string

The conversation id.

Length1 <= length <= 64

Header Parameters

Idempotency-Key?string

Any string up to 255 characters. A repeat with the same key and body answers the stored response; with another body, 409 idempotency_key_reused.

Lengthlength <= 255

Request Body

application/json
  1. body

An internal note to add to the conversation.

body*string

The note, 1 to 4000 characters. Only the team sees it.

Length1 <= length <= 4000

Response Body

The note.

application/json
  1. response

An internal note on a conversation: the team sees it in the inbox, the customer never does.

object*string
id*string
Length1 <= length <= 64
conversation_id*string
Length1 <= length <= 64
body*string

The note's text. Only the team sees it, in the inbox; it is never sent to WhatsApp.

author*

Who wrote the note.

created_at*string
Formatdate-time
Example Request
curl -X POST 'https://api.whatsable.app/v1/conversations/string/notes' \  -H 'Content-Type: application/json' \  -d '{  "body": "Asked for the invoice again; call back Monday."}'
Example Response
{  "object": "conversation_note",  "id": "cm2v8n1a00001qz8h7k8l9m0n",  "conversation_id": "cm2v8c1a00001qz8h4f5g6h7i",  "body": "Asked for the invoice again; call back Monday.",  "author": {    "type": "api_key",    "id": "cm2v8k1a00001qz8h1a2b3c4d",    "name": "Claude"  },  "created_at": "2026-11-04T12:00:00Z"}

Mark a conversation read or unread PATCH

`true` marks the conversation unread in the inbox, as an operator's Mark unread does. `false` marks it read: its `unread_count` goes to 0 and `marked_unread` to false. Sending the state it already has is safe.

Delete an internal note DELETE

Deletes one internal note of the conversation, whoever wrote it, as any member can in the inbox. It cannot be undone.