ZenotiHelp

Set up API authorization

ZTZenoti Docs Team Updated March 7, 2026 2 min readGuide

Authorization controls which API endpoints your backend application can access. Zenoti uses a two-level validation system that checks both the user's security role permissions and the backend application's API group permissions before allowing access to any endpoint.

Before you begin

  • You need a backend application created in Zenoti. See Set up API authentication.
  • Your security role must have the Manage Apps permission enabled.

Permission: Manage API Keys, Manage Apps, and Manage Automation (under Administrator) -- Required to create backend applications and generate API keys.

How authorization works

When your application makes an API call, Zenoti performs two sequential checks:

  1. Security role permissions -- Verifies that the authenticated user has the security role permissions required to access the requested data or operation.
  2. Backend application group permissions -- Confirms that the backend application has been granted access to the API group that contains the requested endpoint.

Both checks must pass for the API call to succeed. If either check fails, the API returns an authorization error.

Example

When an administrator uses an access token to call the Guest APIs:

  1. Zenoti first checks if the administrator's security role includes permission to access guest data.
  2. Zenoti then checks if the backend application has the Guest API group enabled.
  3. Only if both checks pass does the API return the requested data.

Steps

Configure API group permissions

API group permissions are configured during backend application setup:

  1. Navigate to Admin > Organization > Backend Apps in Zenoti.
  2. Select the backend application you want to configure.
  3. In the application settings, locate the API Groups section.
  4. Enable the API groups that correspond to the endpoints your application needs to access:
  • JWT Groups -- Controls access when using token-based authentication (access tokens).
  • APIKEY Groups -- Controls access when using API key authentication.
  1. Save the configuration.

Note: Grant only the minimum API groups your application requires. Overly broad permissions increase security risk.

Verify authorization is working

After configuring group permissions, test with an API call to a protected endpoint. If authorization is configured correctly, you receive the expected data response. If the application lacks the required group permission, you receive an authorization error.

Tips

  • Review API group permissions whenever you add new functionality to your integration. New endpoints may require additional API groups.
  • When debugging authorization errors, check both the user's security role permissions and the backend application's API group settings.
  • Use separate backend applications with tailored API group permissions for different integration use cases.
Was this article helpful?
Your feedback helps us improve our documentation.