Skip to Content
WebhooksEnvelope

Webhook envelope

Each notification contains an occurrence and the affected resource. The type tells you what happened, while data.object contains the resource at the time of the change.

Contract version 2026-09-01.

{
  "id": "we4d2k9p4x1n6v3b8c5q0w2e",
  "type": "membership.purchased",
  "created": "2026-08-31T14:22:07.000Z",
  "api_version": "2026-09-01",
  "org": {
    "id": "j57d2k9p4x1n6v3b8c5q0w2e",
    "slug": "demo-studentforening"
  },
  "data": {
    "object": {
      "id": "ms7d2k9p4x1n6v3b8c5q0w2e",
      "object": "membership_pass",
      "org_id": "j57d2k9p4x1n6v3b8c5q0w2e",
      "status": "active",
      "member": {
        "id": "per_7Kq2Xw9mRb4Tn6Vc",
        "email": "kari.nordmann@stud.ntnu.no",
        "first_name": "Kari",
        "last_name": "Nordmann"
      },
      "membership_id": "mb1d2k9p4x1n6v3b8c5q0w2e",
      "membership_type": {
        "id": "mt3d2k9p4x1n6v3b8c5q0w2e",
        "name": "Ordinært medlemskap"
      },
      "order_id": "m42d2k9p4x1n6v3b8c5q0w2e",
      "issued_reason": null,
      "activation_mode": "auto",
      "single_use": false,
      "activated_at": "2026-08-31T14:22:07.000Z",
      "valid_from": "2026-08-31T14:22:07.000Z",
      "valid_until": "2027-08-31T14:22:07.000Z",
      "amount_paid": 25000,
      "currency": "nok",
      "purchased_at": "2026-08-31T14:22:07.000Z"
    }
  }
}
FieldTypeMeaning
idstringThe occurrence. Stable across retries, redeliveries, and every endpoint that receives it — this is what you dedupe on.
typestringEvent type, e.g. order.completed.
createdstringWhen it happened, ISO 8601 UTC.
api_versionstringThe generation of this contract. Informational — we only ever add fields, so you do not need to branch on it.
org.idstringThe organisation this event belongs to.
org.slugstring | nullTheir URL segment on stello.no.
data.objectobject | nullThe resource this event is about. Which object depends on the type — see the table above. Null on webhook.test.

Identifiers and time

Use the envelope’s id to deduplicate the occurrence. The same occurrence can reach multiple endpoints or arrive again after a retry. A delivery ID identifies a particular delivery record.

Delivery order is not guaranteed. Compare occurrence times where useful and reconcile current state when ordering is ambiguous. An event resource represents an arrangement. A webhook occurrence represents a change to a resource.

Compatibility

Accept unknown fields and safely acknowledge unrecognized types after verifying the signature. The date-based api_version identifies the webhook contract. Read API versions use their own path version.

Data handling

Personal fields are limited to supported names and email addresses. Phone numbers, dates of birth, checkout answers and health data are excluded. Use the stable organization-specific per_… identifier to match a person across supported records.

Read the resource references.