DISCO records events that occur on playlists, including page opens, streams, downloads, etc.
You can query these events via API, or receive them via a webhook.
There are four types of playlist events that record events and trigger webhooks:
- access_playlist: When a playlist is accessed. That can be as a public or shared playlist, or in someone's DISCO inbox.
- play_track: When a track is streamed.
- download_track: When a track is downloaded or added to a DISCO.
- download_zip: When multiple tracks or the entire playlist is downloaded or added to DISCO.
Each event will have a name and other information that may be in context, for example the ID of the track that was streamed.
Considerations for all events
- Actions from users within the DISCO that owns the corresponding playlist will not create events. This is to avoid recording unnecessary events, such as users accessing their own playlists for preview and testing purposes.
- There are no retries for event triggered webhooks. If your endpoint is unavailable, even if its temporary, we will not trigger the webhook again.
- There is only one endpoint that can be specified to receive the webhooks. Webhook payloads include event names to allow for filtering by the webhook recipient.
Please get in touch with us via [email protected] to request access to webhooks.