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	Event type	Description
`ITEM`	Item availability	ItemAvailability	Sends an event when the availability status of an item changes.

`ACCOUNT`	Account status	AccountStatus	Sends an event when the status of an account changes within the platform.
`ACCOUNT`	Transaction	Transaction	Sends an event when funds are added, removed, or transferred to/from your Tango account.
`ACCOUNT`	Low balance	LowBalance	Sends an event when your account reaches a predefined low balance.

`REWARD`	Reward status	RewardStatus	Sends reward status events such as frozen, cancelled, activated, etc.

`ORDER`	Asynchronous order status	AsyncOrderStatus	Sends an event when an asynchronous order has completed processing—whether it was successful, retrying, failed, or partially failed.
`ORDER`	Line item delivery status	LineItemDeliveryStatus	Sends an event when the line item delivery status changes.
`ORDER`	🚧( Coming soon) Order action status	OrderActionStatus	Sends updates on actions (cancel, freeze, and unfreeze) taken on an order.

`PLATFORM`	API credentials	APICredentials	Sends an event every time a platform’s credentials have been changed.

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.