---
title: "Status changed"
method: POST
path: "/registered_url_for_status_change_events"
tags: ["Appointment Webhooks"]
---

# Status changed

`POST /registered_url_for_status_change_events`

When status of an appointment changes, 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.statuschange`.

• **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.

**Example Webhook Request**

**Endpoint:** [https://your-registered-webhook-url.com](https://your-registered-webhook-url.com)

**Method:** POST

## Request body

- object
  - `business_id` string, required — Business ID for the appointment
  - `client_id` string, required — Client ID for the appointment
  - `event` string, required — Type of event
  - `event_time` integer, required — Event occurred timestamp
  - `service` string — Service related to the event
  - `timestamp` integer, required — Timestamp of the event
  - `transaction_id` string — Transaction ID for the event
  - `data` object, required
    - `appointment_id` string, required — Unique appointment ID
    - `clinic_id` string, required — Identifier for the clinic
    - `created_at` integer, required — Creation timestamp
    - `custom_attributes` object — Custom attributes for the appointment
      - `label` string[]
      - `tags` string[]
    - `doctor_id` string, required — Identifier for the doctor
    - `modified_at` integer, required — Modification timestamp
    - `partner_appointment_id` string — Partner's appointment ID
    - `partner_clinic_id` string — Partner’s clinic identifier
    - `partner_doctor_id` string — Partner’s doctor identifier
    - `partner_meta` object — Partner-specific metadata
      - `appointment_id` string
      - `encounter_id` string
      - `facility_id` string
    - `partner_patient_id` string — Partner’s patient identifier
    - `patient_id` string, required — Identifier for the patient
    - `status` string, required — Status of the appointment

## Response `200`

---

[API](https://skmtc.net/eka/apis/eka-developer-apis.md) · [All operations](https://skmtc.net/eka/apis/eka-developer-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eka/eka-developer-apis/versions/9ea23456f722/schema)