Events and Payloads

This is the catalogue of webhook events available to you. Each event has its own page with a description of when it fires and an example of the payload you'll receive.

Every delivery also includes the event name (type) and a unique delivery identifier (uuid) alongside the payload — see Webhooks for how deliveries work.

Listings

Events about the lifecycle of a listing — from pricing and review through to sale, donation, or cancellation.

Event	When it fires
listing.in-review	A listing is being reviewed by our team before going live.
listing.listed	A listing has been published to one or more marketplaces.
listing.sold	A listing has been sold to a buyer.
listing.complete	A listing has completed end-to-end (item received by the buyer, payout sent to the seller).
listing.cancelled	A listing has been cancelled before sale.
listing.donated	A listing has been donated rather than sold.

Users

Events about sellers.

Event	When it fires
user.created	A seller has signed up to Authentified.

Need a new event?

If you have a use case that isn't covered by the events above, let us know via our Canny site and we'll consider adding it.