wherever.audio

Wherever Webhooks

An open format for podcast players to report listening activity (playback, follows, downloads, the queue, and library changes) to an endpoint the user chooses. Events are CloudEvents 1.0, signed per Standard Webhooks, with field names from the Podcast Index API. Any player can send them and any service can receive them.

Version 1.0 (draft)

• Specification: requests, signatures, delivery modes, CORS for browser senders, the event catalogue, versioning, and sender and receiver requirements.
• Schema reference: a readable page for every event, the shared show, episode, and playback-segment references, and the envelope.
• JSON Schemas: the machine-readable index. Each event’s dataschema URL points to its schema.

To receive events, start with Receiving in five minutes. To send them from a player, see Sender requirements.

Information for Developers