Appearance
Webhook events
Hosts add endpoints in the host portal (API & webhooks), vendors in the vendor portal (Webhooks). Each endpoint receives only the events picked for it. How deliveries are signed and retried is in Host API and webhooks.
SAWScore sends its own webhooks, set up inside SAWScore: see SAWScore webhooks.
This table is built from BMA's code with each release.
| Event | When it's sent | Who can subscribe |
|---|---|---|
ad.status_changed | An ad booking in the marketplace was submitted, approved, rejected or cancelled | hosts |
coupon.redeemed | A customer ordered with one of the vendor's coupons | vendors |
customer.created | A host customer organization was created (through the API or its first sign-in) | hosts |
entitlement.granted | A host customer can now use a product (trial, paid or reactivated) | hosts |
entitlement.revoked | A host customer no longer has a product (cancelled or ended) | hosts |
entitlement.suspended | A host customer's product was suspended (for example unpaid) | hosts |
fulfillment.done | A provisioning call to the vendor finished (create, suspend, unsuspend, terminate, change plan) | vendors |
fulfillment.failed | A provisioning call to the vendor failed for good | vendors |
invoice.issued | An invoice was issued | hosts |
invoice.overdue | An invoice is overdue (reminder sent) | hosts |
lead.created | A customer asked for a quote on one of the vendor's lead products (contact details included) | vendors |
lead.status_changed | The vendor marked a lead contacted, won or lost | vendors |
listing.requested | A vendor asked to list a product in the host's marketplace | hosts |
listing.status_changed | A product listing in a marketplace was approved, hidden or rejected | vendors, hosts |
marketplace.status_changed | A marketplace was activated, suspended or archived | hosts |
order.status_changed | An order was placed, approved, rejected, activated or cancelled | hosts |
payment.failed | A card or bank payment failed | hosts |
payment.received | A payment was received on an invoice | hosts |
payout.sent | BMA paid out the vendor's or host's balance | vendors, hosts |
payouts.action_needed | Stripe needs more details before it can pay the vendor or host | vendors, hosts |
product.status_changed | A product was submitted, reviewed, published, returned or delisted | vendors |
request.status_changed | A tenant asked to add a product, or staff approved, rejected or completed the request | hosts |
review.published | A review of the vendor's product was approved and is public | vendors |
statement.ready | A monthly payout statement is ready (what BMA owes the vendor or host) | vendors, hosts |
subscription.plan_changed | A customer changed plan or seat count (now, or at the next renewal) | hosts |
subscription.status_changed | A subscription started, went past due, was suspended, cancelled or ended | hosts |
vendor.status_changed | A vendor was approved, suspended, terminated or sent back | vendors |
Every delivery
json
{
"id": "evt_…",
"type": "entitlement.granted",
"api_version": "2026-11-13",
"created_at": "2026-06-01T15:00:00Z",
"data": { "external_org_id": "dealer-1042", "product": "northwind-desk", "status": "active", "from": "pending" }
}Dedupe on id: an event can arrive twice or late.