SalonifyDevelopers

Tools

Postman & Insomnia

Explore the Salonify API from your favorite API client. Import our ready-made Postman collection in one click, or point either tool at the live OpenAPI spec to generate a complete request set automatically.

Download Postman collectionOpen OpenAPI spec

Two ways in

The fastest route is importing the OpenAPI spec URL directly, which gives you every operation the API exposes and stays current automatically. The downloadable Postman collection is a curated subset of the most common endpoints, pre-wired with collection variables and the X-API-Key header so you can send a request in seconds.

Set up variables

Both the collection and the OpenAPI import use variables so you never hardcode secrets. Fill in these three:

VariableExampleDescription
baseUrlhttps://api.salonify.eu/api/v1API base URL. Already set as the collection default.
apiKeysk_live_your_key_hereYour secret API key, sent as the X-API-Key header.
businessIdyour_business_idThe business your key belongs to. Used in resource paths.

Treat apiKey like a password

Store apiKey as a secret variable (Postman supports a secret type) and keep it in a private environment. Never commit an exported environment that contains a live key. See Authentication.

Postman

Option A: import the collection

  1. Download the collection with the button above (salonify-postman-collection.json).
  2. In Postman, click Import (top left), then drop in the file or choose Upload Files.
  3. Open the new Salonify Public API collection, go to the Variables tab, and set apiKey and businessId under Current value.
  4. Expand a folder (for example Services), open List services, and hit Send. You should get a 200 with a data array.

The collection includes bookings (list + create), services, staff, customers, products, availability, and gift cards (purchase + redeem). Create requests already carry an Idempotency-Key: {{$guid}} header so re-sending will not duplicate.

Option B: import the OpenAPI URL

  1. Click Import, choose the Link tab, and paste the spec URL below.
  2. Postman detects the OpenAPI document and offers to Generate a collection. Confirm.
  3. You get a full collection with every operation grouped by tag, plus a request-level X-API-Key security scheme. Set your variables and send.
OpenAPI spec URL
https://api.salonify.eu/api/v1/openapi.json

Insomnia

Insomnia imports OpenAPI documents natively and turns them into a browsable request collection with environment variables.

  1. In Insomnia, open the Create menu (or the dashboard) and choose Import.
  2. Select URL and paste the OpenAPI spec URL below, then confirm.
  3. Insomnia generates a collection (or design document) with all operations. Open Manage Environments and add an environment with apiKey and businessId.
  4. Add a request header X-API-Key: {{ _.apiKey }} at the folder or collection level so every request inherits it.
  5. Send any request to confirm a 200 response.
OpenAPI spec URL
https://api.salonify.eu/api/v1/openapi.json

Postman collection in Insomnia too

Insomnia can also import the Postman v2.1 collection file directly. Use Import then Fileand select salonify-postman-collection.json. The {{baseUrl}} and {{apiKey}} variables map to Insomnia environment values.

Troubleshooting

  • 401 Unauthorized: the apiKey variable is empty or wrong. Confirm you set the Current value, not just the initial value.
  • 403 Forbidden: your key lacks the scope for that endpoint. Grant the required scope when creating the key. See the badge on each reference page.
  • 404 Not Found: check that businessId matches the business your key belongs to.
  • 429 Too Many Requests: you hit the rate limit. Read Retry-After and back off. See Rate Limits.

Prefer to read the spec interactively? Use the API Explorer, or grab a copy-paste client from SDKs.