> For the complete documentation index, see [llms.txt](https://docs.allmcp.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.allmcp.co/documentation/providers/altegio.md).
# Altegio
Altegio (alteg.io, formerly YClients) is an online booking, CRM, and POS platform for salons, barbershops, and service businesses. AllMCP provides 25 tools for appointments, clients, staff, services, and finances.
All providersHow connecting works
***
## Connect
Altegio needs **three values**: a partner token, a user token, and a company ID.
{% stepper %}
{% step %}
#### Get your credentials
1. Log into the Altegio admin panel.
2. Go to **Integrations → Developer's account**.
3. Under **Account settings**, copy your **Partner token** (the integration API key).
4. Choose **Add app → Access to API**, select the permissions you need, and copy the **User token**.
You'll connect Altegio with these three fields:
* **Partner token** — the integration API key from Account settings.
* **User token** — generated when you add an app under Access to API.
* **Company ID** — the numeric salon or location ID, visible in the Altegio admin URL (multi-location businesses can also ask their agent to list companies to find it).
{% endstep %}
{% step %}
#### Connect through your agent
Ask your agent to connect Altegio and hand it the three values above. AllMCP stores them securely and uses them for every Altegio call.
{% endstep %}
{% endstepper %}
{% hint style="warning" %}
When generating the user token, tick all the access rights you need (appointments, clients, finances, staff). Altegio rejects calls for any permission you didn't grant.
{% endhint %}
***
## Tools by category
### Appointments
| Tool | Description |
| ---------------------------- | --------------------------------------------------------------------------- |
| `altegio_list_appointments` | List appointments, optionally filtered by date, staff member, or client. |
| `altegio_get_appointment` | Get the full details of a single appointment by its ID. |
| `altegio_create_appointment` | Book a new appointment for a client with a chosen staff member and service. |
| `altegio_update_appointment` | Reschedule an appointment or change its status. |
| `altegio_delete_appointment` | Cancel an appointment and remove it from the schedule. |
### Clients
| Tool | Description |
| ----------------------- | ------------------------------------------------------- |
| `altegio_list_clients` | List clients, with optional search by name or phone. |
| `altegio_get_client` | Get the full profile of a single client by their ID. |
| `altegio_create_client` | Add a new client to the salon's contact list. |
| `altegio_update_client` | Update a client's name, phone, email, or other details. |
| `altegio_delete_client` | Remove a client from the salon's records. |
### Staff
| Tool | Description |
| ---------------------- | ---------------------------------------------------------- |
| `altegio_list_staff` | List the staff members who can be booked for appointments. |
| `altegio_get_staff` | Get the full details of a single staff member by their ID. |
| `altegio_create_staff` | Add a new staff member to the salon. |
| `altegio_update_staff` | Update a staff member's name, role, or other details. |
| `altegio_delete_staff` | Remove a staff member from the salon. |
### Services
| Tool | Description |
| ----------------------- | ------------------------------------------------------------------------------------- |
| `altegio_list_services` | List the services in your catalog so you can find the right service ID for a booking. |
| `altegio_get_service` | Look up the full details of a single service by its ID. |
### Finances
These tools cover the manual ledger so you can record and review money movements by hand.
| Tool | Description |
| --------------------------------- | -------------------------------------------------------------------- |
| `altegio_list_transactions` | List financial transactions recorded in the manual ledger. |
| `altegio_get_transaction` | Get the details of a single ledger transaction by ID. |
| `altegio_create_transaction` | Record a new income or expense entry in the ledger. |
| `altegio_update_transaction` | Change the amount, category, or notes on an existing transaction. |
| `altegio_delete_transaction` | Remove a transaction from the ledger. |
| `altegio_list_payment_accounts` | List the payment accounts (cash, card, bank) money can move through. |
| `altegio_list_expense_categories` | List the expense categories you can file transactions under. |
{% hint style="info" %}
Finance tools cover the manual ledger only — not checkout, refunds, or the fiscal register (KKM).
{% endhint %}
### Companies
| Tool | Description |
| ------------------------ | ------------------------------------------------------------------------------------------ |
| `altegio_list_companies` | List all your salon locations and their company IDs — handy for multi-location businesses. |
***
## Common workflows
{% tabs %}
{% tab title="Today" %}
```
List all appointments today for the entire salon
```
{% endtab %}
{% tab title="Book an appointment" %}
```
Book a haircut for client ID 42 with staff member ID 7 on July 1 at 10:00 AM. Service ID is 15.
```
{% endtab %}
{% tab title="New client intake" %}
```
Create a new client: name "Anna Petrova", phone "+380501234567", email "anna@example.com"
```
{% endtab %}
{% endtabs %}
***
## Notes
{% hint style="warning" %}
**Multi-location and required IDs.**
* The company ID you connect with is used for every call by default. If you run several locations, you can point a request at a different location instead.
* Multi-location businesses can ask their agent to list companies to find every location's ID.
* Booking needs a staff ID and a service ID, so list your staff and services first if you don't know them.
{% endhint %}
***
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.allmcp.co/documentation/providers/altegio.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.