Alchem
Partners

Connect your service to salons on Alchem

For app developers and integrators: a salon grants your app access in one click, and you get a key with the right permissions plus install events.

API docs
Install event
install · uninstall · freeze · unfreeze
HTTP
POST <webhook_url>
X-Alchem-Event: install
X-Alchem-Signature: sha256=<hex>

{
  "event": "install",
  "application": "<app_code>",
  "business_id": "<business_id>",
  "installation_id": "<installation_id>",
  "status": "pending",
  "scopes": ["appointments:read", "availability:read"],
  "occurred_at": "2026-10-01T05:00:00Z"
}

How to connect an app

  1. Step 1

    Get in touch

    Tell us about your app. We add it to the Alchem catalog: permissions, install URL, events URL and a developer key.

  2. Step 2

    The salon grants access

    In Settings → Integrations → Apps the salon sees which permissions the app requests and picks branches. The installation waits for your confirmation.

  3. Step 3

    You confirm the installation

    Use the developer key to issue an installation key and call /app/callback — the app becomes connected.

  4. Step 4

    Work through the API

    The installation key works within the granted permissions and those of the staff member who granted access. Either the salon or you can disconnect the app.

What a partner gets

Partner API

List installations, get one, disconnect and issue a key — with the developer key, up to 600 requests per minute.

Install events

install, uninstall, freeze and unfreeze — a POST to your URL signed with X-Alchem-Signature (HMAC-SHA256 with the app secret).

Delivery with retries

No 2xx response — we retry after 1 and 5 minutes, 30 minutes, 2 and 6 hours.

The same permissions as keys

Bookings, clients, contacts, services, specialists, free time and calls — the salon sees what it grants.

  • GET/apps/installationsThe app’s installations at salons
  • GET/apps/installations/{business_id}A single installation
  • POST/apps/installations/{business_id}/uninstallDisconnect the app from a salon
  • POST/apps/installations/{business_id}/keyIssue an installation key

Frequently asked questions

A short guide to how Alchem works and where to start.

Let’s talk about your integration

Start with the API docs — a partner contact will appear on this page soon.

API docsIntegrations