Are your Sugar Calendar Bookings integrations not syncing properly? If external services like Zoom can’t communicate with your WordPress site, webhook-based features won’t work correctly.
In this guide, we’ll show you how to troubleshoot and resolve REST API and webhook connection issues in Sugar Calendar Bookings.
In This Article
Before getting started, make sure Sugar Calendar Bookings is installed and activated on your site.
Understanding Webhooks and the REST API
Sugar Calendar Bookings uses webhooks to enable a real-time connection between your WordPress site and third-party services. These webhooks rely on the WordPress REST API being accessible from external services.
When the REST API is unreachable, integrations like Zoom will only work in one direction. This means that changes you make in WordPress will sync to the external service. However, changes made in the external service won’t sync back to Sugar Calendar Bookings.
Common Causes of Connectivity Issues
There are several reasons why the WordPress REST API might be unreachable on your site. Below are the most common causes and how to resolve them.
Server Misconfiguration (mod_rewrite / .htaccess)
On Apache-based servers, the REST API depends on proper URL rewriting configuration. If the mod_rewrite module is not enabled or your .htaccess file is missing or misconfigured, REST API requests may return a 404 error.
To check if this is the issue, navigate to https://yourdomain.com/wp-json/wp/v2/ in your browser. If you see a JSON response with site information, the REST API is working. If you see a 404 error or blank page, there’s likely a configuration issue.
To resolve this issue:
First, make sure the mod_rewrite Apache module is enabled on your server.
Then, go to Settings » Permalinks in your WordPress dashboard and click Save Changes (even without making edits). This regenerates your .htaccess file.
If the issue persists, verify that your .htaccess file in the WordPress root directory contains the standard WordPress rewrite rules.
Note: If you don’t have access to modify server configurations, contact your hosting provider and ask them to verify that mod_rewrite is enabled for your WordPress installation.
Nginx Missing try_files Directive
On Nginx-based servers, the REST API requires a proper try_files directive in your server configuration. Without it, REST API endpoints may not resolve correctly, especially if your site uses plain permalinks.
Your Nginx server block should include the following directive:
location / {
try_files $uri $uri/ /index.php?$args;
}
Note: If you don’t have direct access to your Nginx configuration, contact your hosting provider and ask them to verify that the try_files directive is correctly configured for your WordPress installation.
Hosting Firewall Rules
Some hosting providers implement server-level firewalls or Web Application Firewalls (WAFs) that may block incoming webhook requests from external services like Zoom.
To resolve this issue, contact your hosting provider and ask them to check whether their firewall is blocking incoming POST requests to your WordPress REST API endpoints.
You can also ask them to whitelist requests from Zoom’s webhook IP addresses if necessary.
Verifying Your REST API Status
You can perform a quick test to determine whether your WordPress REST API is accessible.
Open your browser and navigate to https://yourdomain.com/wp-json/wp/v2/ (replace yourdomain.com with your actual domain name).
If the REST API is working, you’ll see a JSON response containing information about your site and available API endpoints.
If the REST API is not working, you may see:
- A 404 Not Found error
- A 403 Forbidden error
- A blank page
- An HTML error page instead of a JSON response
If your site uses plain permalinks, try the alternative URL format: https://yourdomain.com/?rest_route=/wp/v2/
Note: Even if the alternative URL format works, Sugar Calendar webhooks require the standard REST API URL format (/wp-json/) to function correctly. We recommend switching to a non-plain permalink structure (e.g., Post name) under Settings » Permalinks for full compatibility.
Contacting Your Hosting Provider
If you’ve ruled out plugin conflicts and cannot resolve the issue on your own, you may need to contact your hosting provider.
Frequently Asked Questions
Below, we’ve addressed some of the most common questions regarding REST API and webhook connectivity issues.
Do I need to fix this if I’m not using any integrations?
No. If you’re not using Zoom or other third-party integrations with Sugar Calendar Bookings, you don’t need to enable REST API access for the core booking functionality to work.
Will this affect my existing appointments?
No. The changes won’t modify or edit existing appointments. However, any future changes made within the external service (e.g., canceling or rescheduling a Zoom meeting from the Zoom app) will not sync back to Sugar Calendar until you resolve the REST API issue.
I fixed the issue. How do I know it’s working?
Once the REST API is accessible:
- The admin notice on the Integrations settings page will disappear
- You can verify by visiting
https://yourdomain.com/wp-json/wp/v2/in your browser and confirming you see a JSON response - New webhook events from connected integrations (e.g., Zoom) will begin syncing correctly
I’m using plain permalinks. Can I still use integrations?
We strongly recommend using a non-plain permalink structure (such as Post name) for full compatibility with Sugar Calendar integrations. Plain permalinks can cause issues with REST API routing. It often occurs on Nginx servers that lack the necessary try_files configuration. You can change your permalink structure under Settings » Permalinks in your WordPress dashboard.
What does the admin notice in Sugar Calendar mean?
If Sugar Calendar detects that your REST API may be unreachable, you’ll see an admin notice on the Integrations settings page. It triggers this notice when the plugin performs an internal check against your site’s default REST API route and receives an unsuccessful response. Once the REST API is accessible, the notice will automatically disappear.
Still need help?
If you’ve followed all the steps above and are still experiencing issues, please contact our Trusted Advisers in the support team for additional guidance.
Our team will be happy to help you diagnose and resolve the issue.
That’s it! You now know how to troubleshoot REST API and webhook connectivity issues in Sugar Calendar Bookings.
Next, would you like to learn more about connecting external integrations? Check out our integrations page for a list of supported third-party integrations.
