Skip to Content
WebhooksEvent types

Webhook event types

Subscribe to individual event types or a whole family such as event.*. A family subscription receives newly added types in that family. Resource restrictions limit which records trigger delivery.

The catalogue below is generated from the shared webhook contract. Expand a sample to see a synthetic payload for that exact occurrence.

Memberships membership.*

Event typeObjectSent when
membership.purchasedmembership_passWhen the pass is minted, immediately after payment is captured. Free memberships emit this too.
Sample payload
{
  "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"
    }
  }
}
membership.refundedmembership_passWhen the pass moves to `refunded`. This is the signal to revoke whatever access the membership granted in your own system — Stello's copy stops being valid at the same moment.
Sample payload
{
  "id": "we4d2k9p4x1n6v3b8c5q0w2e",
  "type": "membership.refunded",
  "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"
    }
  }
}

Orders order.*

Event typeObjectSent when
order.completedorderWhen the order moves to `completed`, whichever way it was bought: in the app, at a card terminal, or through web checkout.
Sample payload
{
  "id": "we4d2k9p4x1n6v3b8c5q0w2e",
  "type": "order.completed",
  "created": "2026-08-31T14:22:07.000Z",
  "api_version": "2026-09-01",
  "org": {
    "id": "j57d2k9p4x1n6v3b8c5q0w2e",
    "slug": "demo-studentforening"
  },
  "data": {
    "object": {
      "id": "m42d2k9p4x1n6v3b8c5q0w2e",
      "object": "order",
      "org_id": "j57d2k9p4x1n6v3b8c5q0w2e",
      "receipt_number": "STL-2026-01847",
      "status": "completed",
      "currency": "nok",
      "subtotal_amount": 25000,
      "discount_amount": 0,
      "listed_amount": 25000,
      "amount_to_org": 24000,
      "refunded_amount": 0,
      "coupon_code": null,
      "event_id": "k17d2k9p4x1n6v3b8c5q0w2e",
      "membership_id": null,
      "item_count": 1,
      "buyer": {
        "id": "per_7Kq2Xw9mRb4Tn6Vc",
        "email": "kari.nordmann@stud.ntnu.no",
        "first_name": "Kari",
        "last_name": "Nordmann"
      },
      "completed_at": "2026-08-31T14:22:07.000Z",
      "refunded_at": null,
      "created_at": "2026-08-31T14:21:52.000Z",
      "updated_at": "2026-08-31T14:22:07.000Z"
    }
  }
}
order.refundedorderWhen the order moves to `refunded` or `partially_refunded`. Read `refunded_amount` rather than assuming the whole order went back.
Sample payload
{
  "id": "we4d2k9p4x1n6v3b8c5q0w2e",
  "type": "order.refunded",
  "created": "2026-08-31T14:22:07.000Z",
  "api_version": "2026-09-01",
  "org": {
    "id": "j57d2k9p4x1n6v3b8c5q0w2e",
    "slug": "demo-studentforening"
  },
  "data": {
    "object": {
      "id": "m42d2k9p4x1n6v3b8c5q0w2e",
      "object": "order",
      "org_id": "j57d2k9p4x1n6v3b8c5q0w2e",
      "receipt_number": "STL-2026-01847",
      "status": "completed",
      "currency": "nok",
      "subtotal_amount": 25000,
      "discount_amount": 0,
      "listed_amount": 25000,
      "amount_to_org": 24000,
      "refunded_amount": 0,
      "coupon_code": null,
      "event_id": "k17d2k9p4x1n6v3b8c5q0w2e",
      "membership_id": null,
      "item_count": 1,
      "buyer": {
        "id": "per_7Kq2Xw9mRb4Tn6Vc",
        "email": "kari.nordmann@stud.ntnu.no",
        "first_name": "Kari",
        "last_name": "Nordmann"
      },
      "completed_at": "2026-08-31T14:22:07.000Z",
      "refunded_at": null,
      "created_at": "2026-08-31T14:21:52.000Z",
      "updated_at": "2026-08-31T14:22:07.000Z"
    }
  }
}

Events event.*

Event typeObjectSent when
event.publishedeventWhen the event moves into `published` from any other status, including when a scheduled event publishes itself at its `publish_at` time.
Sample payload
{
  "id": "we4d2k9p4x1n6v3b8c5q0w2e",
  "type": "event.published",
  "created": "2026-08-31T14:22:07.000Z",
  "api_version": "2026-09-01",
  "org": {
    "id": "j57d2k9p4x1n6v3b8c5q0w2e",
    "slug": "demo-studentforening"
  },
  "data": {
    "object": {
      "id": "k17d2k9p4x1n6v3b8c5q0w2e",
      "object": "event",
      "org_id": "j57d2k9p4x1n6v3b8c5q0w2e",
      "title": "Semesterstartfest",
      "slug": "semesterstartfest",
      "description": "Kickoff for høstsemesteret, med konsert og bar.",
      "status": "published",
      "starts_at": "2026-09-12T19:00:00.000Z",
      "ends_at": "2026-09-13T02:00:00.000Z",
      "publish_at": null,
      "first_published_at": "2026-08-20T09:14:00.000Z",
      "location": {
        "name": "Samfunnshuset",
        "address": "Storgata 1",
        "city": "Ålesund",
        "latitude": 62.4722,
        "longitude": 6.1495
      },
      "image_url": "https://cdn.stello.no/events/semesterstartfest.jpg",
      "categories": [
        "Fest",
        "Konsert"
      ],
      "min_age": 18,
      "age_note": "20 for baren",
      "max_capacity": 400,
      "cancel_reason": null,
      "url": "https://stello.no/e/demo-studentforening/semesterstartfest",
      "updated_at": "2026-08-31T14:22:07.000Z"
    }
  }
}
event.updatedeventWhenever any field of the `event` object below actually changes value. Internal bookkeeping that is not part of the object never emits this, so a mirror can apply every one of these blindly.
Sample payload
{
  "id": "we4d2k9p4x1n6v3b8c5q0w2e",
  "type": "event.updated",
  "created": "2026-08-31T14:22:07.000Z",
  "api_version": "2026-09-01",
  "org": {
    "id": "j57d2k9p4x1n6v3b8c5q0w2e",
    "slug": "demo-studentforening"
  },
  "data": {
    "object": {
      "id": "k17d2k9p4x1n6v3b8c5q0w2e",
      "object": "event",
      "org_id": "j57d2k9p4x1n6v3b8c5q0w2e",
      "title": "Semesterstartfest",
      "slug": "semesterstartfest",
      "description": "Kickoff for høstsemesteret, med konsert og bar.",
      "status": "published",
      "starts_at": "2026-09-12T19:00:00.000Z",
      "ends_at": "2026-09-13T02:00:00.000Z",
      "publish_at": null,
      "first_published_at": "2026-08-20T09:14:00.000Z",
      "location": {
        "name": "Samfunnshuset",
        "address": "Storgata 1",
        "city": "Ålesund",
        "latitude": 62.4722,
        "longitude": 6.1495
      },
      "image_url": "https://cdn.stello.no/events/semesterstartfest.jpg",
      "categories": [
        "Fest",
        "Konsert"
      ],
      "min_age": 18,
      "age_note": "20 for baren",
      "max_capacity": 400,
      "cancel_reason": null,
      "url": "https://stello.no/e/demo-studentforening/semesterstartfest",
      "updated_at": "2026-08-31T14:22:07.000Z"
    }
  }
}
event.canceledeventWhen the event moves into `canceled`. `cancel_reason` carries the organiser’s note if they left one.
Sample payload
{
  "id": "we4d2k9p4x1n6v3b8c5q0w2e",
  "type": "event.canceled",
  "created": "2026-08-31T14:22:07.000Z",
  "api_version": "2026-09-01",
  "org": {
    "id": "j57d2k9p4x1n6v3b8c5q0w2e",
    "slug": "demo-studentforening"
  },
  "data": {
    "object": {
      "id": "k17d2k9p4x1n6v3b8c5q0w2e",
      "object": "event",
      "org_id": "j57d2k9p4x1n6v3b8c5q0w2e",
      "title": "Semesterstartfest",
      "slug": "semesterstartfest",
      "description": "Kickoff for høstsemesteret, med konsert og bar.",
      "status": "published",
      "starts_at": "2026-09-12T19:00:00.000Z",
      "ends_at": "2026-09-13T02:00:00.000Z",
      "publish_at": null,
      "first_published_at": "2026-08-20T09:14:00.000Z",
      "location": {
        "name": "Samfunnshuset",
        "address": "Storgata 1",
        "city": "Ålesund",
        "latitude": 62.4722,
        "longitude": 6.1495
      },
      "image_url": "https://cdn.stello.no/events/semesterstartfest.jpg",
      "categories": [
        "Fest",
        "Konsert"
      ],
      "min_age": 18,
      "age_note": "20 for baren",
      "max_capacity": 400,
      "cancel_reason": null,
      "url": "https://stello.no/e/demo-studentforening/semesterstartfest",
      "updated_at": "2026-08-31T14:22:07.000Z"
    }
  }
}

People person.*

Event typeObjectSent when
person.email_changedpersonWhen a person changes the email on their Stello account, and only to organisations where they currently hold something: a membership that has not expired or been refunded, or a ticket to an event that has not ended. Match on `id`; `previous_email` is there for records you created before ids existed.
Sample payload
{
  "id": "we4d2k9p4x1n6v3b8c5q0w2e",
  "type": "person.email_changed",
  "created": "2026-08-31T14:22:07.000Z",
  "api_version": "2026-09-01",
  "org": {
    "id": "j57d2k9p4x1n6v3b8c5q0w2e",
    "slug": "demo-studentforening"
  },
  "data": {
    "object": {
      "id": "per_7Kq2Xw9mRb4Tn6Vc",
      "object": "person",
      "org_id": "j57d2k9p4x1n6v3b8c5q0w2e",
      "email": "kari.nordmann@stud.ntnu.no",
      "previous_email": "kari.n@gmail.com",
      "first_name": "Kari",
      "last_name": "Nordmann",
      "changed_at": "2026-09-27T10:12:44.000Z"
    }
  }
}

Test notifications

webhook.test checks your receiver and has no resource object. It is sent through the dashboard’s test action. Your handler should acknowledge it after verifying its signature.

Testing guide.