Issue with documentation for creating Zoom OAuth app
This week I switched our Zoom API connection type from JWT to OAuth since JWT will be deprecated in June. I followed the instructions in Bookly Settings -> Online Meetings. However I believe the instructions are ambiguous/incorrect. I ran into a ”Zoom connection failed” error in Bookly and an “Invalid client_id error” in Zoom. I saw at least one other person on the Zoom forums with a similar issue.
The issue with the documentation starts at step 11: “Once the app is created, Save the changes on this page”. To me that means you should complete all the steps in Zoom, including activating the app, and *then* save changes in the Bookly settings. However I found that what must be done is to follow all the steps through 10. But *before* you do the final step in Zoom (clicking “Add” on the “Activation” tab), you need to save the changes in Bookly. So it should be something like the following. Steps 1 through 10 are the same as the original (with the exception of changing “whitelist“ to “allow list” in step 9 because that’s the terminology Zoom uses now). Steps 11 onward are altered/new to address the issue I ran into:
(*Suggested new*) Instructions for creating an OAuth App
To find your Client ID and Client Secret, do the following:
- Sign in to your Zoom account
- Visit the Zoom App Marketplace
- Click on the Develop option in the dropdown on the top-right corner and select Build App
- A page with various app types will be displayed. Select OAuth as the app type and click on Create
- Enter the name of your App. In Choose app type select Account-level app and click Create
- After creating your app, fill out descriptive and contact information
- Go to App Credentials tab and look for the Client ID and Client Secret. Use them in the form below on this page
- For Redirect URL for OAuth enter the Redirect URL for OAuth found below on this page
- For allow list URL add a new record with the value of Redirect URL for OAuth found below on this page. If you use both HTTP and HTTPS, make sure to add both records for allow list URL
- Add the scopes required for your app. At the very least, you should select meeting:write:admin
- Once you get to the Activation tab (but *BEFORE* you click Add), Save the changes on this page
- On the Activation tab click Add to Add Your App. It will redirect the page to Bookly Settings
- Click the Connect OAuth button below and complete the connection between Bookly and Zoom
Also, the public online documentation for setting up Zoom doesn’t have the OAuth instructions yet (only the old JWT instructions), so I recommend updating that page as well: https://support.booking-wp-plugin.com/hc/en-us/articles/360013355499-Online-Meetings-Zoom-Google-Meet-Jitsi-BigBlueButton-
Comments
Thank goodness we found your post! Its unbelievable to me that it is so difficult to set this up...and the fact that bookly hasnt updated the instructions since you described this issue so clearly. I feel sorry for people who have gotten notices from zoom and struggled with this like we did.
Hello,
The instruction is up to date here: https://support.booking-wp-plugin.com/hc/en-us/articles/360013355499-Online-Meetings-Zoom-Google-Meet-Jitsi-BigBlueButton-
Hi, I have problem please, when I added URL at activation step, it's not redirect to the page to Bookly Settings, it's give me ( zero value at the browser) what is causing this please?
Ahmed, I got the zero value in the browser when I followed the old instructions (clicking “Add” on Zoom before saving the changes in Bookly). So make sure you save the new settings in Bookly first (step 11 above) and then click Add in the Activation step in Zoom (step 12 above). I hope that helps.
This Bookly / Zoom setup is a nightmare. I have done this step by step from the supposedly "new" instructions, and after finally getting connected, now is a whole new error: "Zoom: Access token is expired". Have been screwing around with this app, waiting days on end to get responses to support tickets. This app has held my business up now for 3 weeks. Time to try something different.
Hello Adonis,
To resolve this issue, review the staff profile card and verify the type of connection. If 'Default' is selected, refresh the token in Bookly > Settings > Online Meetings by clicking Disconnect OAuth and reconnecting.
If 'OAuth2.0' is selected, disconnect the staff member from Zoom on their profile card and reconnect to refresh the token.
For those who use third-party servers to host their sites, it is important to enable Zoom ports on the server so that you do not have any issues or connection problems.
https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0060548
Please sign in to leave a comment.