Altegio connects to your own applications, integrations and AI assistants. Developers get an access key (also called an API key, partner token or Bearer token) in the Altegio Developer Hub. AI assistants, such as Claude or ChatGPT, connect through ready-made Marketplace apps or Altegio MCP servers, without any keys.
When to use
- You are developing your own application or integration with the Altegio API and need an access key.
- Your server needs to receive notifications about changes in the location, for example new appointments or changes in client data.
- You want to work with Altegio data from an AI assistant, for example ask Claude how revenue changed last month.
Where to find Integrations and access
The Integrations and access block in the location settings has 3 sections:
- Access keys: for developers of their own applications and integrations. Leads to the Altegio Developer Hub, where the access key is issued.
- Webhooks: the webhook settings page. The page hasn’t changed.
- AI assistants: for connecting an AI assistant. No access key is needed.
To open the Integrations and access block:
- In Administration mode, click Settings in the left menu.
- Find the Integrations and access block and click the section you need.
Getting an access key for your integration
An access key is needed for a program that accesses location data without logging in as a team member. Access keys are issued in the Altegio Developer Hub, where you register a developer account. You don’t need to contact support or fill in the partner form to get an access key.
Access key and user key
Requests to location data in the Altegio API are signed with 2 keys:
- Access key: belongs to your developer account and is shown in the Developer Hub. In the Altegio API documentation, the access key is called the partner token and is passed as a Bearer token.
- User key: returned by the API authorization method in response to the login and password of an Altegio user. The user key determines on whose behalf the application works with the data. In the Altegio API documentation, the user key is called the user token.
Step 1. Open the Developer Hub
- Open Settings > Integrations and access > Access keys.
- Click Go to Developer Hub.
What opens after you click Go to Developer Hub depends on whether you already have a developer account. If you don’t have a developer account yet, the Developer Hub registration page opens: go to Step 2. If you already have a developer account, your Developer Hub account opens right away: go to Step 3.
Step 2. Register in the Developer Hub
- In Developer company name, enter the name of your company or your own name.
- In What do you need API access for?, select what you are going to use the API for.
- Check the Contact details block. Name, Phone number and Email are filled in from your Altegio profile. An Altegio manager may contact you using these details, so make sure they are up to date.
- In Website, enter the website of your company.
- Click Register.
The Developer Hub registration form has no token field: you don’t need a Bearer token to register.
Step 3. Copy the access key
The Developer Hub account page has the My API keys block, the AI assistants block and a block with the access key of your developer account.
- Find the Access key field.
- Copy the access key and save it in a secure place.
Important. The access key is a private key. Don’t show it to anyone and don’t publish it in open code, for example in a public repository.
The user key is returned by the API authorization method in response to the login and password of an Altegio user. The ways to get a user key and the list of API methods are described in the Altegio API documentation.
Webhook settings
The Webhook settings page opens from Settings > Integrations and access > Webhooks.
Connecting an AI assistant to Altegio
An AI assistant doesn’t need an access key to work with Altegio. To choose how to connect an AI assistant, open Settings > Integrations and access > AI assistants.
The AI assistants page has 2 cards: ready-made AI solutions from the Marketplace and your own AI assistant through MCP.
Ready-made AI solutions from the Marketplace. On the AI assistants page, the first card leads to AI apps in the Altegio Marketplace, for example AI receptionists that reply to clients and book appointments 24/7. Each app has its own price, shown on the app card.
Your own AI assistant through MCP. On the AI assistants page, the second card is for AI apps that support MCP servers, such as Claude, ChatGPT or Cursor. The card links to 3 Altegio MCP servers:
- Altegio Pro MCP: reads and changes the data of your locations: appointments, team members, services, work schedules, clients and settings.
- Altegio Pro MCP (read-only): reads the same data and the full set of analytics, but cannot change anything.
- Altegio Integrations Hub MCP: for developers who build applications for the Altegio Marketplace.
To connect an Altegio MCP server, you sign in with your Altegio email and password. No access key or token is needed. What each server can do read in Altegio MCP servers for AI assistants.
FAQ
Open Settings > Integrations and access > Access keys and click Go to Developer Hub. If you don’t have a developer account, register in the Developer Hub. Copy the key from the Access key field in your Developer Hub account.
No. The access key is issued in the Altegio Developer Hub: open Settings > Integrations and access > Access keys and click Go to Developer Hub. The Developer Hub registration form doesn’t ask for a token.
Yes. The Integrations and access block doesn’t affect access keys and tokens issued earlier. Integrations that use them keep working, and you don’t need to issue new keys.
The Developer tools item is no longer in Settings > System settings. The webhook settings are in Settings > Integrations and access > Webhooks. The Webhook settings page hasn’t changed.
No. When you click Go to Developer Hub in Settings > Integrations and access > Access keys, your Developer Hub account opens right away, without registration.
No. Open Settings > Integrations and access > AI assistants and choose a ready-made AI app from the Marketplace or one of the Altegio MCP servers. To connect an Altegio MCP server, you sign in with your Altegio email and password.
The access key belongs to your developer account and is shown in the Developer Hub. The user key is returned by the API authorization method in response to the login and password of an Altegio user, and it determines on whose behalf the application works with the data. Requests to location data in the Altegio API are signed with both keys.