Webhook Event Reference

All event types delivered by Ummat webhooks, with example payloads.

Event types

Type	Trigger	Required scope
`event.created`	A new event is published by an entity	`events:read`
`event.cancelled`	A published event is cancelled	`events:read`
`prayer_times.updated`	An entity updates their iqamah schedule	`prayer-times:read`
`donation.completed`	A donation is marked as completed	`donations:read`
`donation.refunded`	A donation is refunded	`donations:read`
`member.added`	A user is added to an entity	`members:read`
`member.removed`	A user is removed from an entity	`members:read`
`claim.approved`	An entity verification claim is approved	`entity:read`
`claim.rejected`	An entity verification claim is rejected	`entity:read`
`service.degraded`	Ummat API service degradation detected	none

event.created

{
  "id": "evt_01hzxxxxx",
  "type": "event.created",
  "created_at": "2026-05-03T14:22:00Z",
  "api_version": "2026-05",
  "data": {
    "event_id": "uuid",
    "entity_id": "uuid",
    "title": "Jumuah Khutbah",
    "starts_at": "2026-05-10T12:30:00Z",
    "ends_at": "2026-05-10T13:30:00Z",
    "is_online": false,
    "location": "Main Prayer Hall"
  }
}

event.cancelled

{
  "type": "event.cancelled",
  "data": {
    "event_id": "uuid",
    "entity_id": "uuid",
    "title": "Jumuah Khutbah",
    "cancelled_at": "2026-05-09T18:00:00Z",
    "reason": "Unforeseen circumstances"
  }
}

prayer_times.updated

{
  "type": "prayer_times.updated",
  "data": {
    "entity_id": "uuid",
    "schedule_id": "uuid",
    "effective_from": "2026-05-01",
    "effective_until": null,
    "is_ramadan_override": false,
    "fajr": "05:15",
    "dhuhr": "13:00",
    "asr": "16:30",
    "maghrib": "sunset",
    "isha": "21:00",
    "jumuah_1": "13:00",
    "jumuah_2": null
  }
}

donation.completed

{
  "type": "donation.completed",
  "data": {
    "donation_id": "uuid",
    "entity_id": "uuid",
    "amount_cents": 5000,
    "currency": "USD",
    "fund_designation": "General",
    "completed_at": "2026-05-03T14:22:00Z"
  }
}

member.added / member.removed

{
  "type": "member.added",
  "data": {
    "entity_id": "uuid",
    "user_id": "uuid",
    "role": "admin",
    "added_at": "2026-05-03T14:22:00Z"
  }
}

service.degraded

Sent to all active webhook subscriptions when Ummat detects an API service degradation. No scope required.

{
  "type": "service.degraded",
  "data": {
    "service": "graphql",
    "severity": "partial",
    "message": "Elevated error rates detected on GraphQL endpoint",
    "status_url": "https://status.ummat.dev"
  }
}