Cobalt sends webhook events to notify you about activities in your EHR system. There are two types of webhook events:

Operation Webhook Events

These events are sent when Cobalt performs an RPA (Robotic Process Automation) operation inside your EHR system. These are actions that Cobalt initiated, such as:
  • Creating appointments (appointment.created)
  • Creating patients (patient.created)
  • Updating appointments (appointment.updated)
  • Uploading notes (note.uploaded)
Operation events confirm the success or failure of actions that Cobalt performed on your behalf.

Sync Webhook Events

These events are sent when Cobalt detects changes that occurred directly in your EHR system. These are notifications about activities that happened in the EHR itself, such as:
  • Appointments created by staff (appointment.created)
  • Patient information updated (patient.updated)
  • Status changes (appointment.status_updated)
Sync events keep you informed about changes happening in your EHR system in real-time.

Available Events

The specific events available to you depend on your Cobalt configuration and EHR system. To see which events you can enable or disable, please refer to the webhook configuration section in your Cobalt dashboard.

Example Event Payloads

Operation Event Example

This example shows an appointment.created event that was triggered by a Cobalt operation:
{
  "id": "759df7ac-2688-44a9-926c-58d36376b412",
  "access_token_reference_id": "clinic_1",
  "object": "event",
  "created": "2025-07-28T16:05:48.929Z",
  "type": "appointment.created",
  "data": {
    "mrn": "44235",
    "timezone": "America/New_York",
    "date_time": "2025-07-28T16:00:00.000Z",
    "provider_id": "defe69ae-f363-4797-87bd-1c70acb52b21",
    "provider_name": "Dr. Jose Gonzalez",
    "appointment_id": "c5c0e613fc7d68a1c01ef4160483a0b6"
  }
}

Sync Event Example

This example shows an appointment.updated event that was triggered by a change detected in the EHR:
{
  "id": "508c368e7de13b40f9397eec966d0329",
  "access_token_reference_id": "clinic_1",
  "object": "event",
  "created": "2025-07-28T08:50:42.491-07:00",
  "type": "appointment.updated",
  "data": {
    "id": "0551c88b2249945151f967525ee3f7b4",
    "status": "2",
    "datetime": "2025-07-28T16:00:00.000Z",
    "duration": 20,
    "location": "2",
    "patient_mrn": "804",
    "patient_name": "John Doe",
    "provider_name": "Dr. Michael Denenberg",
    "appointment_mode": "office",
    "appointment_type": "FOLLOW-UP",
    "ehr_appointment_id": "482129",
    "updated_fields": {
      "status": "2"
    }
  }
}