Quickstart

1. Create an API key

In the business dashboard open Developers → API keys → Create key. The key starts with bw_live_ and is shown once, so copy it straight away.

2. List the services

curl https://api.bewtee.com/api/v1/services \
  -H "Authorization: Bearer $BEWTEE_API_KEY"

{
  "status": true,
  "message": "OK",
  "data": [
    {
      "id": 10,
      "name": "Haircut",
      "description": null,
      "category": { "id": 1, "name": "Hair" },
      "price": 500,
      "currency": "INR",
      "duration_minutes": 45,
      "gender": "unisex"
    }
  ]
}

3. Find a free slot

curl -G https://api.bewtee.com/api/v1/availability \
  -H "Authorization: Bearer $BEWTEE_API_KEY" \
  --data-urlencode "date=2026-11-16" \
  --data-urlencode "service_ids[]=10"

Each slot is a start time at which a staff member is free for the whole booking.

4. Create the booking

curl https://api.bewtee.com/api/v1/bookings \
  -H "Authorization: Bearer $BEWTEE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-42" \
  -d '{
    "date": "2026-11-16",
    "time": "14:00",
    "service_ids": [10],
    "customer": { "name": "Asha Rao", "phone": "9876543210", "email": "[email protected]" }
  }'

The response is the booking, with status set to pending or, when the business accepts bookings automatically, accepted. See the booking lifecycle.

5. Listen for changes

Add a webhook so your system hears when the business confirms, moves or cancels the booking, instead of polling.