---
title: "IPD Admission Event"
method: POST
path: "/registered_url_for_ipd_admissions_events_events"
tags: ["IPD Webhooks"]
---

# IPD Admission Event

`POST /registered_url_for_ipd_admissions_events_events`

When an event occurs against an IPD admission (such as a clearance, stage change or other workflow action), a webhook event is sent to registered webhooks describing the action that was performed.

**Field Definitions**

• **service**: string - The type of service. For IPD events, this will be `ipd`.

• **event**: string - The type of event. This will be `ipd_admissions_events.created` or `ipd_admissions_events.updated`.

• **event_time**: integer - Event occurrence timestamp (epoch seconds).

• **transaction_id**: string - Unique transaction identifier for the event.

• **timestamp**: integer - Timestamp of the event (epoch seconds).

• **business_id**: string - The eka ID of the business.

• **client_id**: string - Client ID associated with the event.

• **data**: object - Contains details about the admission event.

• **kind**: string - The kind of event (e.g. `CLEARANCE`).

• **by**: object - The actor who performed the action.

• **to**: string - The resulting state of the action (e.g. `COMPLETED`).

**Example Webhook Request**

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

**Method:** POST

## Request body

- object
  - `service` string, required — Type of service
  - `event` 'ipd_admissions_events.created' | 'ipd_admissions_events.updated', required — Type of event
  - `event_time` integer, required — Event occurred timestamp
  - `transaction_id` string — Unique transaction identifier for the event
  - `timestamp` integer, required — Timestamp of the event
  - `business_id` string, required — Business ID for the admission
  - `client_id` string — Client ID for the admission
  - `data` object, required
    - `at` string — Timestamp when the event occurred
    - `by` object — Actor who performed the action
      - `id` string — Actor identifier
      - `name` string — Actor name
    - `clearance_type` string — Type of clearance (present when kind is CLEARANCE)
    - `id` string, required — Unique identifier for the event
    - `kind` string, required — Kind of admission event
    - `to` string — Resulting state of the action

## Response `200`

---

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