Skip to content
ReferenceForDeveloperHost ownerVendor ownerVendor developer

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.

EventWhen it's sentWho can subscribe
ad.status_changedAn ad booking in the marketplace was submitted, approved, rejected or cancelledhosts
coupon.redeemedA customer ordered with one of the vendor's couponsvendors
customer.createdA host customer organization was created (through the API or its first sign-in)hosts
entitlement.grantedA host customer can now use a product (trial, paid or reactivated)hosts
entitlement.revokedA host customer no longer has a product (cancelled or ended)hosts
entitlement.suspendedA host customer's product was suspended (for example unpaid)hosts
fulfillment.doneA provisioning call to the vendor finished (create, suspend, unsuspend, terminate, change plan)vendors
fulfillment.failedA provisioning call to the vendor failed for goodvendors
invoice.issuedAn invoice was issuedhosts
invoice.overdueAn invoice is overdue (reminder sent)hosts
lead.createdA customer asked for a quote on one of the vendor's lead products (contact details included)vendors
lead.status_changedThe vendor marked a lead contacted, won or lostvendors
listing.requestedA vendor asked to list a product in the host's marketplacehosts
listing.status_changedA product listing in a marketplace was approved, hidden or rejectedvendors, hosts
marketplace.status_changedA marketplace was activated, suspended or archivedhosts
order.status_changedAn order was placed, approved, rejected, activated or cancelledhosts
payment.failedA card or bank payment failedhosts
payment.receivedA payment was received on an invoicehosts
payout.sentBMA paid out the vendor's or host's balancevendors, hosts
payouts.action_neededStripe needs more details before it can pay the vendor or hostvendors, hosts
product.status_changedA product was submitted, reviewed, published, returned or delistedvendors
request.status_changedA tenant asked to add a product, or staff approved, rejected or completed the requesthosts
review.publishedA review of the vendor's product was approved and is publicvendors
statement.readyA monthly payout statement is ready (what BMA owes the vendor or host)vendors, hosts
subscription.plan_changedA customer changed plan or seat count (now, or at the next renewal)hosts
subscription.status_changedA subscription started, went past due, was suspended, cancelled or endedhosts
vendor.status_changedA vendor was approved, suspended, terminated or sent backvendors

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.