Notes events

Outbound webhook events for notes: when each one fires and the exact JSON payload Centerfy POSTs to your URL.

3 events. Subscribe to them in Settings → API & Webhooks → Webhooks or with the outbound webhook subscription endpoints. Delivery, authentication headers and the common envelope are described in the webhooks overview.

EventWhen it fires
note.createdA note is added to a contact — from any source (the Notes UI, the create-note webhook, a CRM mirror). A restored (un-deleted) note also fires this.
note.updatedAn existing (active) note’s content is edited.
note.deletedA note is deleted (the app soft-deletes by deactivating it). The payload carries the note’s last state.

note.created

Note created. A note is added to a contact — from any source (the Notes UI, the create-note webhook, a CRM mirror). A restored (un-deleted) note also fires this.

{
  "event": "note.created",
  "occurred_at": "2026-06-20T14:30:00.000Z",
  "sub_account_id": "<sub account uuid>",
  "organization_id": "<organization uuid>",
  "note": {
    "id": "<uuid>",
    "contact_id": "<uuid>",
    "content": "Spoke with Jane — interested in the Pro plan, follow up Friday.",
    "agent_id": null,
    "user_id": "<uuid>",
    "created_at": "2026-06-20T14:00:00.000Z",
    "updated_at": "2026-06-20T14:30:00.000Z"
  }
}

note.updated

Note updated. An existing (active) note’s content is edited.

{
  "event": "note.updated",
  "occurred_at": "2026-06-20T14:30:00.000Z",
  "sub_account_id": "<sub account uuid>",
  "organization_id": "<organization uuid>",
  "note": {
    "id": "<uuid>",
    "contact_id": "<uuid>",
    "content": "Spoke with Jane — interested in the Pro plan, follow up Friday.",
    "agent_id": null,
    "user_id": "<uuid>",
    "created_at": "2026-06-20T14:00:00.000Z",
    "updated_at": "2026-06-20T14:30:00.000Z"
  }
}

note.deleted

Note deleted. A note is deleted (the app soft-deletes by deactivating it). The payload carries the note’s last state.

{
  "event": "note.deleted",
  "occurred_at": "2026-06-20T14:30:00.000Z",
  "sub_account_id": "<sub account uuid>",
  "organization_id": "<organization uuid>",
  "note": {
    "id": "<uuid>",
    "contact_id": "<uuid>",
    "content": "Spoke with Jane — interested in the Pro plan, follow up Friday.",
    "agent_id": null,
    "user_id": "<uuid>",
    "created_at": "2026-06-20T14:00:00.000Z",
    "updated_at": "2026-06-20T14:30:00.000Z"
  }
}
© 2026 Centerfy AI. All rights reserved.