ZenotiHelp

Use organization APIs

ZTZenoti Docs Team Updated March 7, 2026 2 min readGuide

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.

API reference

Was this article helpful?
Your feedback helps us improve our documentation.