Supported webhook events

We support webhook events in Tango API via subscription. Use POST {URI}/webhooks endpoint to subscribe to webhook events and receive timely notifications for events occurring within Tango. See how you can Create a subscription. To retrieve the information about a specific event type such as low balance, see Get all subscription event types.

By subscribing to Tango's webhook events you can be notified by the following events and event types:

Category	Event type	Description
`ITEM`	ItemAvailability	Sends an event when the availability status of an item changes.
`ACCOUNT`	AccountStatus Transaction LowBalance	Sends an event when the status of an account changes within the platform. Sends an event when funds are added, removed, or transferred to/from your Tango account. Sends an event when your account reaches a predefined low balance
`REWARD`	RewardStatus	Sends reward status events such as frozen, cancelled, activated, etc.
`ORDER`	AsyncOrderStatus LineItemDeliveryStatus OrderActionStatus 🚧(Coming soon)	Sends an event when an asynchronous order has completed processing—whether it was successful, retrying, failed, or partially failed. Provides delivery updates for physical gift card line items, such as a status change from `IN_PROGRESS` to `SHIPPED`. Sends updates on actions (cancel, freeze, and unfreeze) taken on an order.
`PLATFORM`	APICredentials	Sends an event every time a platform’s credentials have been changed.
`FINANCIAL`	ExchangeRatesProcessed 🚧(Coming soon)	Sends an event every time Tango’s daily currency exchange rates are updated.

Events payloads follow the following format:

Property	Type	Description
`eventId`	string	The unique ID associated with the specific event
`revision`	long	The position of the event within the subscription.
`eventType`	eventType	The type of the event that occurred such as `ItemAvailability`, `AccountStatus`, `RewardStatus`, etc.
`category`	eventCategory	The event category you want to subscribe to, such as `ITEM`, `ACCOUNT`, `REWARD`, `ORDER`.
`eventOccurredAt`	timestamp	Includes the timestamp of the event.