apaleo Inventory API

Name: apaleo Inventory API
Brand: apaleo Inventory API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentProductivityCalendar Schedulingoauth229 EndpointsREST

For Agents

Set up and manage hotel properties, units, unit groups, and unit attributes in the apaleo PMS via OAuth 2.0.

Install Jentic One Beta

Connect the apaleo Inventory API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the apaleo Inventory API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with apaleo Inventory API.

Create, update, and list hotel properties (the top-level entity in apaleo)

Manage units (rooms, parking lots, beds, meeting rooms) including bulk creation

Group units into unit groups (e.g., single rooms, double rooms) for rate and availability mapping

GET STARTED

Start building with apaleo Inventory API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI specification for apaleo Inventory API, keeping it validated and agent-ready. apaleo is a property management system (PMS) for hotels and the inventory API exposes the structural data that everything else hangs off: properties (hotels), units (rooms, parking lots, beds, meeting rooms), unit groups (single rooms, double rooms), unit attributes, and the country and type lookups behind them. Authentication is OAuth 2.0 against apaleo's identity service, and the property lifecycle is exposed through dedicated action endpoints (clone, archive, set-live, reset).

Use Cases

Patterns agents use apaleo Inventory API for, with concrete tasks.

★ New-property onboarding

Onboard a new hotel into apaleo by creating the property, defining its unit groups (single, double, suite), bulk-creating the actual units, and finally calling the set-live action so reservations can flow. The agent uses /inventory/v1/properties to create the property, /inventory/v1/unit-groups to define groups, /inventory/v1/units/bulk to create rooms, and /inventory/v1/property-actions/{id}/set-live to activate.

POST /inventory/v1/properties with the new hotel data, POST unit groups, POST /inventory/v1/units/bulk for the rooms, then PUT /inventory/v1/property-actions/{id}/set-live

Audit and report on hotel inventory

Generate an inventory audit report for a hotel chain showing property counts, unit counts per property, and unit groups. The agent calls /inventory/v1/properties/$count and /inventory/v1/units/$count to get totals, then iterates properties and pulls /inventory/v1/units and /inventory/v1/unit-groups for each to build the report.

GET /inventory/v1/properties/$count, GET /inventory/v1/units/$count, then for each property GET /inventory/v1/units?propertyId= and aggregate counts by unit group

Clone a property to a sister hotel

Stand up a new hotel in apaleo that shares structure with an existing one. The agent calls /inventory/v1/property-actions/{id}/clone, then patches the new property's identifying fields (code, name, address) and the unit attributes that differ. This is faster than rebuilding unit groups and attributes from scratch.

PUT /inventory/v1/property-actions/{id}/clone with the source property id, then PATCH the cloned property's name and address

AI agent integration via Jentic

An agent supporting a hotel operations team can search Jentic for 'create a hotel property' and Jentic returns the apaleo inventory operation with its schema. apaleo OAuth 2.0 client credentials live in the Jentic vault, so the agent does not handle the client id and secret or the token refresh.

Search Jentic for 'create a hotel property in apaleo', load the /inventory/v1/properties schema, and POST the new property

Key Endpoints

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

METHOD

PATH

DESCRIPTION

GET

/inventory/v1/properties

List hotel properties

GET

/inventory/v1/properties/{id}

Fetch a single property

GET

/inventory/v1/units

List units in a property

POST

/inventory/v1/units/bulk

Bulk-create units in a property

GET

/inventory/v1/unit-groups

List unit groups (e.g., single, double)

PUT

/inventory/v1/property-actions/{id}/clone

Clone a property to a new property

PUT

/inventory/v1/property-actions/{id}/set-live

Set a property live so it can accept reservations

PUT

/inventory/v1/property-actions/{id}/archive

Archive a property

GET

/inventory/v1/properties

List hotel properties

GET

/inventory/v1/properties/{id}

Fetch a single property

GET

/inventory/v1/units

List units in a property

POST

/inventory/v1/units/bulk

Bulk-create units in a property

GET

/inventory/v1/unit-groups

List unit groups (e.g., single, double)

Why Jentic?

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

Credential isolation

apaleo OAuth 2.0 client credentials are stored in the Jentic vault (MAXsystem). Jentic handles token fetch, refresh, and scope-aware injection per call, so the agent never sees the client secret or the access token.

Intent-based discovery

Agents search Jentic by intent ('create a hotel property', 'set a property live', 'bulk create rooms') and Jentic returns the matching apaleo inventory operation with its parameter schema, removing the need to read the apaleo API reference.

Time to first call

Direct integration: 1-2 days for OAuth setup and validating the property-action lifecycle. Through Jentic: under an hour - search, load, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Cloudbeds API

Cloud-based PMS targeting independent hotels and B&Bs.

Pick Cloudbeds for independent hotels with built-in distribution; pick apaleo for hotel chains needing a stricter inventory model with unit groups and property actions.

Complementary

Stripe API

Card payment acceptance for hotel reservations.

Use Stripe to charge for the reservation; use apaleo to manage the property, units, and unit groups behind it.

Complementary

GitHub API

Source control for the integration code that calls apaleo.

Use GitHub to manage the apaleo integration's source repo and CI; use apaleo for the runtime hotel operations.

FAQs

Specific to using apaleo Inventory API through Jentic.

Why is there no official OpenAPI spec for apaleo Inventory API?

apaleo does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call apaleo Inventory API via 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 apaleo Inventory API use?

OAuth 2.0 against apaleo's identity service. Through Jentic the client id and secret live in the encrypted MAXsystem vault, and Jentic fetches and refreshes the bearer token on the agent's behalf, so the secret never enters the agent context.

Can I bulk-create rooms in an apaleo property?

Yes. POST /inventory/v1/units/bulk accepts an array of unit definitions and creates them in one call, which is much faster than POSTing /inventory/v1/units individually when onboarding a new hotel wing.

How do I set a property live through Jentic?

Search Jentic for 'set an apaleo property live', load the schema for /inventory/v1/property-actions/{id}/set-live, and PUT it for the property id. Once live, the property can accept reservations through other apaleo APIs.

What are the rate limits for the apaleo Inventory API?

apaleo applies fair-use limits at the OAuth 2.0 client level; specifics are not declared in the OpenAPI spec. Bulk endpoints (units/bulk) reduce request count when onboarding many rooms.

What is the difference between a unit and a unit group?

A unit is a single bookable resource (a room, parking lot, bed, or meeting room). A unit group bundles units that share a rate and availability profile (e.g., 'single rooms' or 'double rooms'). Rates and availability hang off unit groups, not individual units.