Getting Started

Salonify API

The Salonify REST API lets you manage bookings, services, staff, customers, products, gift cards, loyalty, payments, and more, programmatically. Build custom integrations, sync data with your own systems, and automate your salon or studio operations.

Quickstart

Three steps to your first successful request.

1. 1

   Create an API key

   In your dashboard, open Settings → Developer, create a key, and select the least-privilege scopes your integration needs. Copy the key value (sk_live_…) immediately, it is shown only once.

2. 2

   Authenticate with the X-API-Key header

   Send your key in the X-API-Key header on every request. See Authentication.

3. 3

   Make your first request

   List your services to confirm everything is wired up correctly.

curl "https://api.salonify.eu/api/v1/businesses/{businessId}/services" \
  -H "X-API-Key: sk_live_your_key_here"

Response envelope

Single-object responses wrap the payload in a data key:

{
  "data": {
    "id": "svc_8f3a...",
    "name": "Classic Cut",
    "price": 35.0
  }
}

List endpoints return a data array plus a meta object with pagination details. See Pagination.

{
  "data": [ /* array of resources */ ],
  "meta": {
    "total": 137,
    "page": 1,
    "limit": 20,
    "totalPages": 7
  }
}

Conventions

• All requests and responses use JSON. Send Content-Type: application/json on writes.
• Timestamps are ISO 8601 in UTC (for example 2026-06-22T09:30:00.000Z).
• Monetary amounts are decimal numbers in the business currency unless noted.
• Identifiers are opaque strings. Do not parse or rely on their format.
• Writes are scoped to the business that owns the API key. You cannot act on another business.
• Errors follow a consistent shape. See Errors.

Explore the API