Set up webhooks for webinars

« To Riverside integrations: Overview

Send your webinar registration and attendance events to any CRM, marketing platform, or automation tool the moment they happen. Push real-time webinar activity into your own systems so you can build a custom integration to virtually any CRM, marketing platform, or no-code automation tool.

Step by step

1. On a computer, log into your account
2. In the bottom-left corner, click the account menu button.
3. Click Settings.
4. Under Your account, click Integrations.
5. Click Webhooks. 
6. Click Create subscription.
   The Create webhook subscription panel opens. In the Name field, enter a label that helps you recognize this endpoint later. 
7. In the Destination URL field, enter the HTTPS endpoint where Riverside sends the events. 
8. Under Events, select which of the 6 webinar events to send to this endpoint:
   • webinar.created, when a webinar is scheduled
   • webinar.started, when the host clicks Go live
   • webinar.ended, when the webinar ends
   • registrant.created, when someone registers
   • attendee.joined, in real time when an attendee joins live
   • registrant.did_not_attend, per registrant after the webinar ends
9. Click Create.
10. In the Save your signing secret window, click Copy, then store the secret somewhere secure on your server. You need it to verify that incoming requests came from Riverside. 
11. Click Done.
    Your subscription now appears in the Webhooks list, showing its name, destination URL, the number of selected events, and an ACTIVE status. 

Manage a webhook subscription

After you create a subscription, you can test it, check whether events are reaching your endpoint, change what it sends, regenerate its signing secret, and pause or delete it. 

1. On a computer, log into your account
2. In the bottom-left corner, click the account menu button.
3. Click Settings.
4. Under Your account, click Integrations.
5. Click Webhooks.
6. Click •••  [the three dots].
7. From the menu, choose an action:
   • Send test event sends a sample of one event type to your destination URL, so you can confirm your endpoint is set up correctly before real events fire.
   • View logs opens the Delivery log for the subscription. You can filter by status, by event, and by a From and To date range, expand a row for detail, and click the resend icon on a row to re-send an event to your endpoint. 
   • Edit subscription changes the name, destination URL, or selected events. Click Save to apply your changes. 
   • Pause delivery stops sending events to this endpoint. After you confirm, the subscription shows as Disabled. To turn it back on, select Resume delivery.
   • Regenerate secret generates a new signing secret. The current one stops working immediately, so update your receiving server with the new secret to keep verifying webhook signatures. 
   • Delete subscription removes the subscription permanently. This cannot be undone, so to receive events again you create a new subscription.

Good to know

• You can create more than one subscription, each pointing at a different endpoint.
• A subscription is set at the account level and applies to every webinar in your account. 
• Your endpoint must be a publicly reachable HTTPS URL and must respond within 10 seconds. Riverside does not follow redirects.
• The same event can arrive more than once and events are not guaranteed to arrive in order, so treat each event id as unique and use the event timestamp if order matters.

Learn more

• Riverside API docs: Webhooks Overview
• Riverside Business API