Skip to Content
Public APIAdd Note

Add Note

Attach a free-text note to a contact. Notes are visible to your agents on the contact’s profile in the inbox — push context from your CRM, ticketing system, or order history so agents see it inline.

By default the note is appended to the contact’s existing notes on a new line. Set append: false to overwrite instead.

Endpoint

POST https://api.splashifypro.com/api/v1/public/contacts/notes

Headers

HeaderValue
AuthorizationBasic YOUR_API_KEY
Content-Typeapplication/json

Request body

Identify the contact by either phone_number or contact_id.

{ "phone_number": "919876543210", "note": "Called about renewal — wants a callback on Friday", "append": true }
FieldRequiredNotes
phone_numberone ofCustomer’s phone in country-code + number format (no +).
contact_idone ofThe contact’s UUID. Takes precedence over phone_number
noteyesThe note text
appendnotrue (default) appends to existing notes on a new line; false overwrites them

Example

curl -X POST https://api.splashifypro.com/api/v1/public/contacts/notes \ -H "Authorization: Basic YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "phone_number": "919876543210", "note": "Called about renewal — wants a callback on Friday" }'

Successful response — 200 OK

{ "result": true, "message": "Note added successfully", "notes": "Imported from CRM on signup\nCalled about renewal — wants a callback on Friday" }

notes is the contact’s full notes field after the update.

Error response — 404 Not Found

{ "result": false, "message": "Contact not found" }

Status codes

CodeMeaning
200 OKNote added
400 Bad Requestnote empty, or no valid contact identifier
401 UnauthorizedAPI key invalid or missing
404 Not FoundNo active contact matches the identifier
429 Too Many RequestsRate limit exceeded

Implementation tips

  • The contact’s notes are a single free-text field. Append mode joins entries with a newline — prefix your own timestamp or source label if you need structure (e.g. "[2026-06-20 CRM] ...").
  • Use append: false for a “sync the latest state” pattern where the note should always reflect a single current value.