Use organization APIs
The organization APIs let you retrieve and update organization-level settings and configuration. Use these APIs to access business-wide settings that affect all centers, including booking rules, payment configuration, membership policies, employee settings, and feature flags.
For complete endpoint documentation including request/response schemas and code examples, see the individual API reference articles linked below.
Before you begin
- You need a valid API key or access token. See Set up API authentication.
- Organization-level settings require administrator access.
Permission: Manage API Keys (under Administrator) -- Required to access Zenoti APIs.
Retrieve organization settings
GET /v1/organizations/settings/{section}
Retrieves organization settings for a specific configuration section. Different sections return different configuration models.
| Parameter | Type | Required | Description |
|---|---|---|---|
| section | string | Yes | The settings section to retrieve |
Available settings sections
| Section | Description | Key fields |
|---|---|---|
| Booking wizard | Appointment hold time, overlap rules, interval configuration | Hold time, overlap allowance, booking intervals |
| General | Account name, feature flags, tax settings | Memberships, packages, classes, gift cards enablement; AWS S3 config |
| Employee | Check-in methods, biometric access, leave policies | Biometric check-in, tip declaration rules |
| Memberships | Redemption rules, freeze rules, credit usage | Redemption limits, freeze policies |
| Payment | Payment method configuration, offline check requirements | Payment method enablement, field requirements |
| Custom data labels | Custom field labels, form access restrictions | Label names, access rules |
| Zenoti Mobile | Geofence, signature capture settings | Geofence radius, signature requirements |
| Training | Fitness kiosk enablement | Kiosk configuration |
| Feedback | Feedback version configuration | Feedback form versions |
Update organization settings
PUT /v1/organizations/settings
Saves organization or center settings. The request body mirrors the response structure from the retrieve endpoint for the relevant section.
Manage class milestones
Create a milestone
POST /v1/organizations/milestones
Creates a milestone at the organization level for classes.
List all milestones
GET /v1/organizations/milestones
Retrieves all available class milestones for the organization.
Update a milestone
PUT /v1/organizations/milestones/{milestone_id}
Updates the details of an existing milestone.
Delete a milestone
DELETE /v1/organizations/milestones/{milestone_id}
Deletes a milestone.
Tips
- Cache organization settings locally and refresh on a schedule rather than retrieving them before every API call.
- Organization-level settings affect all centers. Test changes in a staging environment before applying them to production.