Webhooks: Notification Events

The Notification Event webhook fires whenever FolioReady sends a notification to a client. Use it to log client communication into your own CRM, build a shared activity feed, or relay notifications to additional channels.

Every payload is { event, client, folio, notification }.

notification.sent

When fired: When a notification is sent to the client. The service field on the notification object indicates how it was delivered — direct email, SMS, or via a connected service such as Gmail, Intercom, or Salesforce.

{
  "event": "notification.sent",
  "client": {
    "id": 412,
    "guid": "f4a13d0c-2e5e-4a7d-9b1f-2e5a8f8d24c1",
    "user_guid": "1c3a9e8f-72b5-4d11-89aa-66ec0f3a4b22",
    "email": "client@example.com",
    "first_name": "Pat",
    "last_name": "Morgan",
    "phone": "+1-555-0142",
    "subscribed": "yes",
    "inserted_at": 1746825600,
    "updated_at": 1746825600
  },
  "folio": {
    "guid": "8b9d7c12-aa7e-4a2c-b91d-3ad7c2f81f54",
    "client_guid": "f4a13d0c-2e5e-4a7d-9b1f-2e5a8f8d24c1",
    "type": "inbound",
    "name": "Onboarding",
    "status": "open",
    "template_guid": "a72b1c4a-19fc-4d68-8ac6-b6ccf1f3e000",
    "folio_sections": [],
    "inserted_at": 1746825000,
    "updated_at": 1746829200
  },
  "notification": {
    "folio_guid": "8b9d7c12-aa7e-4a2c-b91d-3ad7c2f81f54",
    "service": "google_gmail",
    "type": "review_request",
    "email": "client@example.com",
    "subject": "Please review your onboarding folio",
    "inserted_at": 1746829200,
    "updated_at": 1746829200
  }
}

More information

For headers, signing, retries, and the delivery log, see the Webhooks overview.