Connecting the Events app to a Server-to-Server OAuth app in your Zoom account

The Events app integrates with Zoom so that you can associate a Soapbox Event with a Zoom Meeting or Webinar and have registered attendees of a Soapbox Event automatically created as Zoom registrants. This will create personalized Zoom Meeting or Webinar links for each attendee.

To connect the Events app to your Zoom account, you must have a Zoom paid account of the Pro level or higher and have access to the Zoom user that is the owner of your account. To connect the Events app to Zoom Webinars, you must have the Webinars paid add on with Zoom.

To connect your Zoom account with Soapbox, you must first create a Server-to-Server OAuth app in Zoom through the following steps:

1. Go to https://marketplace.zoom.us/
2. Login as the Zoom user that is the owner of your account
3. Click the Develop drop down to open it
4. Click Build App
5. For "Choose your app type", click Create for Server-to-Server OAuth
6. In the popup, enter an App Name. This will be for internal use only so you can name it whatever you'd like.
7. Click Create
8. On the next screen under App Credentials, copy and paste the values for the Account ID, Client ID, and Client Secret in a temporary place for use later
9. Click Continue
10. On the next screen for Information, enter the Basic Information and Developer Contact Information. This will be for internal use only so you can name it whatever you'd like.
11. Click Continue
12. On the next screen for Features, click Continue
13. On the next screen for Scope, click Add Scopes
14. In the popup, select each of the following:
    1. Meeting > View all user meetings
    2. Meeting > View and manage all user meetings
    3. Webinar > View all user webinars
    4. Webinar > View and manage all user webinars
    5. User > View all user information
    6. User > View users information and manage users
    7. Account > View account info
15. In the popup, click Done
16. On the main page, click Continue
17. On the next screen, click Activate Your App

Once this has been done, you're ready to add your Zoom credentials to the Soapbox Engage Events app. To do so:

1. Login to your Soapbox administrator
2. Open the Configuration for the Events app
3. Click the Integration tab
4. For Enable Zoom Integration by Default, choose the default setting for your Zoom integration Keep the default of No if you plan to use the Zoom integration for a subset of your events. You will then enable the integration on an event by event basis. If you will be using the Zoom integration for most or all of your events, you may wish to set it as Yes. In either case, you can override this default for each event.
5. For Zoom App Type, select Server-to-Server OAuth. NOTE: If you are updating your integration from JWT to Server-to-Server OAuth, you may wish to leave the Zoom App Type as blank or JWT until you have confirmed the credentials in step 9.
6. For Server-to-Server OAuth Account ID, enter the Account ID you copied from your Zoom app
7. For Server-to-Server OAuth Client ID, enter the Client ID you copied from your Zoom app
8. For Server-to-Server OAuth Client Secret, enter the Client Secret you copied from your Zoom app
9. To confirm that the credentials successfully authenticate to Zoom, click Test Server-to-Server OAuth credentials. If updating your integration from JWT to Server-to-Server OAuth and you waited to set the Zoom App Type to Server-to-Server, you may wish to select that now.
10. For Restricted Users, if you wish to limit the integration to only specific Zoom Users, enter a comma-separated list of their Zoom User Ids. The Zoom User Id can be found by those with admin privileges in Zoom by going to Admin > User Management > Users. From there, click on a user to open their detail view. Their Zoom User Id will be included in the URL for the detail view.
11. Click Apply
12. Once the page refreshes after applying these settings, the name of the Zoom Account Owner should appear under the credentials, if Soapbox was successful in connecting to your Zoom account

If you are updating your integration from JWT to Server-to-Server OAuth, it is highly recommended that you confirm that integration is working. You can do so by confirming that you are able to select a Zoom Meeting or Webinar for a given event and / or registering for an event that is integrated with Zoom and confirming that a registrant is created in Zoom.