JAjane
Webhooks

Register a webhook subscription

Registers a new webhook subscription for the authenticated partner. The signing secret is returned only in this response and cannot be retrieved again — store it securely. The secret is used to verify that webhook payloads are sent by Jane.

post/api/2026-01-01/webhooks

Request

  • Base URL
    https://jdpdocsdemo.jane.qa
  • URL
    https://jdpdocsdemo.jane.qa/api/2026-01-01/webhooks
  • Auth
    OAuth 2
    Authorization code: https://login.id.janeapp.com/realms/jane_partner_sandbox/protocol/openid-connect/auth?response_type=code&resource=https://jdpdocsdemo.jane.qa&prompt=consent
    Token URL: https://login.id.janeapp.com/realms/jane_partner_sandbox/protocol/openid-connect/token scopes: webhooks:create

Request body

event_topicstring required

The event topic to subscribe to

target_urlstring required

The HTTPS URL that will receive webhook event payloads

Response

The webhook subscription was registered

idstring uuid required

Unique identifier for the webhook subscription

event_topic'APPOINTMENT_BOOKED' | 'APPOINTMENT_CANCELLED' | 'APPOINTMENT_UNCANCELLED' | 'APPOINTMENT_RESCHEDULED' required

The event topic this subscription receives

target_urlstring required

The HTTPS URL that receives webhook event payloads

clinic_guidinteger required

The clinic identifier this subscription belongs to

status'active' | 'inactive' required

Whether the subscription is currently active

updated_atstring date-time required

When the subscription was last updated

created_atstring date-time required

When the subscription was created

secretstring

HMAC signing secret for verifying webhook payload authenticity. Present only on initial registration.

Changes

No recorded changes to this operation across all 2 revisions of this API.