Sign in

v1

latestOpenAPI 3.0.32026-07-26229361630.0 KB
Appointment Webhooks

Assessment Taken

When an assessment linked to the appointment is completed, a webhook event is sent to registered webhooks with details about the appointment, including the appointment ID, status, doctor ID, patient ID, and event type.

Field Definitions

• event: string - The type of resource for which event is generated. Here, it will be appointment.assessments.taken.

• service: string - The type of service. For appointments, this will be appointment.

• data: object - Contains detailed information about the appointment event.

• appointment_id: string - Unique identifier for the appointment.

• doctor_id: string - Unique identifier for the doctor.

• patient_id: string - Unique identifier for the patient.

• status: string - Status of the appointment. Possible values can be

  • "BK" (Booked),

  • "OG" (Ongoing),

  • "CM" (Completed with Prescription),

  • "CMNP" (Completed without Prescription),

  • "CN" (Cancelled).

• action: string - Current action for the appointment. Possible values can be

- created

- modified

- completed

• partner_meta: key value pair specified by partner while creating appointment.

• timestamp: string (ISO 8601) - The date and time when the event occurred.

• custom_attibutes: complete set of custom attributes(inclusing tags and labels) defined against this appointment. occurred.

• sa_ids: List of self assessment IDs.

• workflow_data: List of self assessment data.

Example Webhook Request

Endpoint: https://your-registered-webhook-url.com

Method: POST

post/registered_url_for_assessment_taken_events

Request body

eventstring required

Type of event

event_timeinteger required

Event occurred timestamp

servicestring

Service related to the event

transaction_idstring

Transaction ID for the event

timestampinteger required

Timestamp of the event

business_idstring required

Business ID for the appointment

client_idstring required

Client ID for the appointment

Example request

{
  "event": "appointment.assessments.taken",
  "event_time": 1749544696,
  "service": "appointment",
  "transaction_id": "d-bcebe31d-5a73-4d05-bd4f-0fdef45dcb86",
  "timestamp": 1730189586,
  "business_id": "75682005283056",
  "data": {
    "appointment_id": "api-abb67007-1e53-4f0f-b428-a4bc025468a4",
    "clinic_id": "678faea412e547001db5c639",
    "created_at": 1749544579,
    "custom_attributes": {
      "label": [
        "vital_submitted"
      ],
      "tags": [
        "87"
      ]
    },
    "doctor_id": "171458899473447",
    "modified_at": 1749544696,
    "partner_appointment_id": "67ce9032abfba8001d17ddd2",
    "partner_clinic_id": "CL04",
    "partner_doctor_id": "1712660285igfewifwe",
    "partner_meta": {
      "key1": "value1"
    },
    "partner_patient_id": "77237637763817-17",
    "patient_id": "174436114490384",
    "sa_ids": [
      "sa_25061014072610653"
    ],
    "status": "CK",
    "workflow_data": {
      "sa_25061014072610653": "3970"
    }
  }
}