Contacts::Events::Note

Create Contact Activity Note

Changed on

Save a note synchronously in the contact's Activity tab with content and optional occurred_at. Attributed to the token's current membership and shown via API in Activity. Missing or blank content and an unparsable occurred_at return 422. No outgoing webhooks are emitted.

post/contacts/{contact_id}/events/notes

Request

Path parameters

contact_idstring required

Request body

Example request

{
  "contacts_events_note": {
    "content": "Called about the refund; promised a callback on Friday.",
    "occurred_at": "2026-10-12T14:03:00.000Z"
  }
}

Response

Created

idinteger

The same id as the contact event.

public_idstring
contact_idinteger
contentstring nullable

The note text. Legacy blank notes may be null.

created_by_idinteger nullable

Membership id; uses the recorded membership or the author's membership in this workspace's team. Workflow notes have no author and return null.

occurred_atstring date-time
created_atstring date-time
updated_atstring date-time

Example response

{
  "id": 912345679,
  "public_id": "GhIjKl",
  "contact_id": 123,
  "content": "Called about the refund; promised a callback on Friday.",
  "created_by_id": 456,
  "occurred_at": "2026-10-12T14:03:00.000Z",
  "created_at": "2026-10-13T09:15:22.000Z",
  "updated_at": "2026-10-13T09:15:22.000Z"
}

Changes