Introduction to the aleno API
In this article, you’ll learn what the aleno API is, what you can do with it, and see a common example (creating reservations).
What is the aleno API?
The aleno API allows you to connect your own applications or systems (POS, PMS, websites, apps, custom dashboards) directly to aleno.
With it, you can:
-
Read and update restaurant data (restaurants, shifts, availability, reservations, customers)
-
Automate tasks (e.g. create or modify reservations automatically, update guest profiles)
-
Get real-time updates via webhooks (notifications when reservations or customers change)
The API is based on GraphQL, which means you can request exactly the data you need in one query.
Important Note
aleno provides access to the API and documentation, but we do not offer technical support for custom integrations.
-
Implementation is fully on your side
-
We recommend working with a developer or technical partner if you are not familiar with APIs
-
Our [API documentation in Apollo Explorer] contains the technical details you need
Common Use Cases for the API
Many of our customers use the API to:
-
Sync reservations with external systems (e.g. custom websites, apps, or booking tools)
-
Connect POS/PMS systems if a direct integration is not yet available
-
Build custom dashboards to analyze guest and reservation data
-
Automate guest communication by pulling reservation data into marketing tools
-
Create hotel-to-restaurant connections (e.g. when a hotel booking should trigger a restaurant reservation)
Example: Creating Reservations
One of the most common API use cases is creating reservations directly from another system.
To do this, you typically:
-
Create or fetch a customer (guest profile)
-
Check availability for the desired date and shift
-
Create a reservation using the guest, restaurant, shift, and date information
Example result:
You send a request with guest details, date, time, and number of people → aleno creates the reservation and returns a confirmation with the reservation ID.
Frequently Asked Questions
Do I need coding skills to use the API?
Yes. The aleno API is designed for developers. If you don’t have coding experience, we recommend working with a developer or technical partner.
Can I test the API safely?
Yes. You can use our test environment (https://test.gateway.aleno.me) before making changes in production.
What happens if I lose my API token?
Tokens are only shown once when created. If you lose a token, you’ll need to reset it in the aleno dashboard under Users → API Users.
Are tokens permanent?
Currently, tokens don’t expire automatically, but this may change in the future. You can always reset them manually.
Can aleno help me implement the API?
No. We provide the API and documentation, but the implementation is your responsibility.
Next Steps
-
Explore the full API schema and examples in the [aleno Apollo Explorer]
-
Subscribe to webhooks to automatically receive updates (e.g. new reservations)
-
Check the Changelog to stay updated on new fields or breaking changes