Add a note

POST/api/v2/contacts/{username_or_id}/notes

Adds a note to a contact.

Rate limit 300 requests per minute

Headers

x-api-keyheaderRequired
Your API key.
Content-TypeheaderRequired
application/json

Path parameters

username_or_idstringRequired
Instagram username or contact id.

Body

notestringRequired
Up to 1,000 characters.
created_bystring
Email of the team member who wrote it. Defaults to the organization owner.

Errors

Error	When
400`invalid_note`	`note` is missing or longer than 1,000 characters.
400`invalid_created_by`	created_by is not a valid email address.
403`user_not_in_organization`	The created_by email belongs to someone outside your organization.
404`unknown_created_by`	No user with the created_by email.
404`contact_not_found`	No contact with that username or id in your organization.

Request

curl -X POST "https://app.dmtracker.ai/api/v2/contacts/jane.fitness/notes" \
  -H "x-api-key: $DMTRACKER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "note": "Asked about pricing, call booked for Friday"
  }'

Response 201

{
  "status": "success",
  "message": "Note added",
  "contact": {
    "id": "7c1e9a52-3f4b-4d2a-9e61-0b8f2d5c4a17",
    "username": "jane.fitness",
    "full_name": "Jane Cooper"
  },
  "data": {
    "id": 9812,
    "note": "Asked about pricing, call booked for Friday",
    "created_at": "2026-10-29T10:07:30.000+00:00",
    "created_by": "owner@yourcompany.com"
  }
}