API & Webhooks

With the Salonnare API and webhooks you connect your salon to other software: your accounting package, your own website, a newsletter service or a custom dashboard. You do not need to be a developer to understand what they do -- this page explains it calmly.

What is an API?

An API (Application Programming Interface) is an agreement that lets two programs talk to each other. Where you click a button in the app to load an appointment, another program can request the same data through the API -- automatically and without manual steps.

Practical examples for a salon:

• Your accounting software automatically pulls your revenue every night.
• Your own website shows your services and prices straight from Salonnare.
• An integration partner syncs your client list.

Access to the API works through an API key: a secret code that proves the request comes from you. Treat that key like a password.

Creating an API key

1. Go to Settings -> API & Webhooks.
2. Click New API key.
3. Give the key a recognisable name (for example "Accounting") and choose the permissions: read-only or read and write.
4. Copy the key immediately and store it safely. For security reasons Salonnare shows the full key only once.

Suspect a key has leaked? Delete it right away -- every integration using that key stops immediately.

What is a webhook?

A webhook is the reverse of the API. Instead of you fetching data, Salonnare automatically sends a message to an address (URL) of yours the moment something happens. The other software no longer has to keep asking "is there anything new?" -- it gets a signal by itself.

Salonnare can send events such as:

• booking.created -- a new appointment was created
• booking.updated -- an appointment was changed
• booking.cancelled -- an appointment was cancelled
• payment.received -- a payment was received
• client.created -- a new client was created
• client.updated -- client details were changed

Setting up a webhook

1. Go to Settings -> API & Webhooks and open the Webhooks tab.
2. Click New webhook.
3. Enter the URL where Salonnare should send the notifications (your integration partner or developer provides this).
4. Choose the events you want to react to.
5. Save. You can then review the delivery logs to see whether the notifications arrive correctly.

Working securely

• Never share API keys publicly (not in email, screenshots or code posted online).
• Give an integration only the permissions it truly needs -- choose read-only where possible.
• Delete keys and webhooks you no longer use.

Because Salonnare processes your data in the EU and you decide which integrations get access, you keep full control over your data. Need help with an integration? Feel free to reach out through the support page.