Developers

Aphra for developers

Connect your salon’s Aphra account to your own website, CRM, accounting package or automation tool.

There are four ways in:

What Use it for Needs a key
REST API Read bookings, customers and invoices. Create bookings from your own systems. Yes
Webhooks Get a signed POST to your server the moment a booking is made, cancelled, completed or marked as no-show. No, you register a URL
Public endpoints Show your treatments, prices and free times on a site of your own. No
Embed Put the booking page itself on your website, inline or as a popup. No

If you only want a “Book now” button on your website, you need the embed and nothing else. The API is for when you write code that runs on a server.

Base URL

https://app.aphrabooking.com

All API paths in these pages are relative to that address. Everything runs over HTTPS. Requests and responses are JSON.

Quick start

  1. In Aphra, go to Settings → API and create a key. Tick only the scopes you need. Copy the key right away: it is shown once.
  2. Call the API with the key in the Authorization header:
curl https://app.aphrabooking.com/api/v1/bookings?limit=5 \
  -H "Authorization: Bearer key_live_..."
  1. You get your five most recent bookings back:
{
  "bookings": [
    {
      "id": "6f1c2a5e-...",
      "reference": "K7Q2MX",
      "status": "confirmed",
      "startsAt": "2026-11-20T14:00:00+00:00",
      "endsAt": "2026-11-20T15:00:00+00:00",
      "total": 65,
      "currency": "USD",
      "notes": null,
      "createdAt": "2026-11-14T09:12:44.120+00:00"
    }
  ],
  "limit": 5,
  "offset": 0
}

Who can do what

Only the owner or an admin of a business can create API keys and webhooks. A key belongs to one Aphra account and sees all of that account’s data, across all its locations. It never sees another business.