Set up webhooks for recordings and exports

« To Riverside integrations: Overview

Trigger your own workflows the moment a recording or export is ready, so you can download the files to your storage, CMS, or other tools automatically.

Who: Account owner and admins
Plan: Business
Device: Computer browser

Step by step

  1. On a computer, log in to your Riverside account.
  2. In the bottom-left corner, click the account menu button.
  3. Select Settings.
  4. Under Your account, select Integrations.
  5. Click Webhooks.
  6. Click Create subscription.
  7. Under Name, enter a name you’ll recognize.
  8. Under Destination URL, enter the HTTPS endpoint that should receive the events.
  9. Under Events, select which of these events to send to this endpoint.
    • recording.ready sends an event when a recording’s individual tracks are ready to download.
    • export.completed sends an event when an export finishes and its file is ready to download.
  10. Click Create.
  11. Under Save your signing secret, click Copy and store the secret securely on your server.
    • The secret appears only once. Use it to confirm that requests come from Riverside.
  12. Click Done.
    Your subscription now appears in the Webhooks list.

Update an existing webhook subscription

  1. In Webhooks, next to the relevant subscription, click •••  [the three dots].

  2. Click Edit subscription.

  3. Check recording.ready, export.completed, or both, and click Save. 

Good to know Icon.svg Good to know

  • To test, pause, or delete a subscription, or to view its delivery logs, see Set up webhooks for webinars. These options work the same for every event.

  • Each event includes download links, that work with the account’s API key and don’t expire.
  • Subscriptions apply to your whole account. Riverside sends events for every recording and export, from both studio sessions and webinars.
  • Practice takes, timeline exports, and failed exports don’t send events.
  • When recording.ready is sent, the combined recording of all participants may still be processing. Your workflow can download it later using the Riverside API.

Learn more