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/notesHeaders
| Header | Value |
|---|---|
Authorization | Basic YOUR_API_KEY |
Content-Type | application/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
}| Field | Required | Notes |
|---|---|---|
phone_number | one of | Customer’s phone in country-code + number format (no +). |
contact_id | one of | The contact’s UUID. Takes precedence over phone_number |
note | yes | The note text |
append | no | true (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
| Code | Meaning |
|---|---|
200 OK | Note added |
400 Bad Request | note empty, or no valid contact identifier |
401 Unauthorized | API key invalid or missing |
404 Not Found | No active contact matches the identifier |
429 Too Many Requests | Rate 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: falsefor a “sync the latest state” pattern where the note should always reflect a single current value.