Cituro API

Name: Cituro API API
Brand: Cituro API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentProductivityCalendar SchedulingapiKey, basic24 EndpointsREST

For Agents

Manage Cituro customers, services, employees, and company settings for an appointment-booking business. Supports creating bookings prerequisites, updating customer records, and listing services with their assigned staff and locations.

Quickstart

Get started with Cituro API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"create a customer in Cituro"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Cituro API API.

Create and update customer profiles with attached notes for an appointment-booking business

Configure bookable services and link them to the employees who can deliver them

Maintain employee records and the locations where each employee works

Read and patch company-level settings such as opening hours and contact details

GET STARTED

Start building with Cituro API API

Explore with Jentic

View OpenAPI Document

Use for: I need to create a new customer in our gym booking system, Update a customer's contact details before sending a reminder, List all services we offer and which employees can deliver them, Find all employees assigned to a yoga class service

Not supported: Does not handle payment processing, calendar event creation, or marketing email — use for managing the customer, service, and employee records behind a Cituro booking experience only.

Jentic publishes the only available OpenAPI document for Cituro API, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for Cituro API, keeping it validated and agent-ready. Cituro is an appointment booking and resource scheduling platform used primarily by gyms, studios, and service businesses to manage customers, services, employees, and bookable locations. The API exposes customer profiles with notes, configurable services, employee assignments, and company-level settings, so a booking front-end or back-office tool can read and modify the full scheduling graph. It uses an X-API-KEY header (or HTTP Basic with the key as the username) and returns standard JSON resources for each entity.

Use Cases

Patterns agents use Cituro API API for, with concrete tasks.

★ Customer database sync for a studio chain

Keep an external CRM or marketing tool aligned with the Cituro customer list by pulling customers via GET /customers and pushing edits with PATCH /customers/{id}. The API supports per-customer notes through /customers/{id}/notes, so qualitative context from staff stays attached to the canonical record. Useful for studios that want their newsletter audience and Cituro contact list to match without manual exports.

List all customers modified in the last 30 days, then PATCH each one whose email changed in the source CRM

Service catalogue and staffing maintenance

Manage the menu of bookable services and the employees assigned to each one. Agents can create a new service via POST /services, update its details with PATCH /services/{id}, and read the assigned staff via GET /services/{id}/employees. Locations available for a service are managed through /services/{id}/locations, including a full replacement with PUT.

Create a new 60-minute Pilates service priced at 30 EUR, assign two named employees, and set its location to studio-A

Company profile audit

Read company-wide configuration with GET /company and apply controlled edits via PATCH /company. This is the right entry point for an agent that needs to verify or correct top-level information such as the legal name, contact email, or address before it appears on a booking widget.

GET the company profile, check that the support email matches a known good value, and PATCH it if it does not

Agent integration via Jentic

Through Jentic, an AI assistant can take an instruction like "add a new customer named Marie Dubois with this email" and resolve it to the correct Cituro endpoint, schema, and authentication header without the developer wiring the call by hand. Jentic stores the X-API-KEY in its credential vault and only injects it at execution time.

Search Jentic for 'create a customer in Cituro', load the schema for POST /customers, and execute it with the parsed name and email

Key Endpoints

24 endpoints — jentic publishes the only available openapi specification for cituro api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/customers

List customers

POST

/customers

Create a customer

PATCH

/customers/{id}

Update a customer

GET

/services

List bookable services

GET

/services/{id}/employees

List employees assigned to a service

GET

/employees

List employees

GET

/company

Get company profile

GET

/me

Get the authenticated user

GET

/customers

List customers

POST

/customers

Create a customer

PATCH

/customers/{id}

Update a customer

GET

/services

List bookable services

GET

/services/{id}/employees

List employees assigned to a service

GET

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Cituro X-API-KEY values are stored encrypted in the Jentic vault. The agent receives a scoped reference, never the raw key, so prompts and logs cannot leak it.

Intent-based discovery

Agents search Jentic with intents like 'create a Cituro customer' or 'list services with their employees'. Jentic returns the matching operation, its input schema, and the auth requirement so the agent can call it directly.

Time to first call

Direct integration against the Cituro PDF reference: 1-2 days to read the doc, model the endpoints, and wire auth. Through Jentic: under 30 minutes — search, load schema, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

CiviCRM REST API

CiviCRM stores the broader contact and membership record that a Cituro customer often maps to.

Choose CiviCRM when the source of truth for the contact lives in a non-profit CRM and Cituro only holds the booking-side projection.

Alternative

Clarkup API

Clarkup is another small-business contact and pipeline tool with overlapping customer-management surface.

Pick Clarkup if the user is running a sales-led service business rather than a class-based studio.

Complementary

Clarra API

Clarra handles matter and case-style scheduling for professional services that Cituro does not target.

Use Clarra when the booking unit is a legal matter or case rather than a gym class.

FAQs

Specific to using Cituro API API through Jentic.

Why is there no official OpenAPI spec for Cituro API?

Cituro does not publish an OpenAPI specification — the public reference is a PDF on cituro.com. Jentic generates and maintains this spec from the documentation so AI agents and developers can call Cituro through structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Cituro API use?

Cituro accepts an API key sent in the X-API-KEY HTTP header, or HTTP Basic Authentication where the API key is the username and the password is left empty. Through Jentic, the key is stored encrypted in the credential vault and never enters the agent's prompt context.

Can I create and update customers with the Cituro API?

Yes. POST /customers creates a new record, GET /customers/{id} reads one, and PATCH /customers/{id} applies a partial update. You can also attach freeform notes via POST /customers/{id}/notes and edit them with PATCH /customers/{id}/notes/{noteId}.

How do I assign employees to a service through Jentic?

Search Jentic for 'list employees for a Cituro service', which returns GET /services/{id}/employees, then use POST or PATCH on the service or employee resources to adjust assignments. The Jentic SDK loads the input schema so the agent fills in the right fields without reading the raw spec.

What are the rate limits for the Cituro API?

The OpenAPI spec does not declare formal rate limits. Treat 429 responses as rate-limited and back off; for production use, contact Cituro support to confirm the per-account quota that applies to your key.

Does the Cituro API expose booking creation directly?

The endpoints in this spec cover the prerequisites for bookings — customers, services, employees, locations, and company configuration — rather than a write endpoint for an individual appointment. Use these endpoints to keep the booking graph in sync with external systems.