Organization Setup
Overview
After registering and creating your organization, you need to complete a setup checklist before clients can book. This guide walks you through each step in the recommended order.
Check your current setup status at any time:
GET /api/org/setup-status
Authorization: Bearer your-token
Step 1: Organization Profile
Your profile is the public-facing page that clients see when they discover your business. Fill it in completely — this directly affects trust and conversion.
GET /api/org/organization-profile
PUT /api/org/organization-profile
Recommended fields to fill:
| Field | Why it matters |
|---|---|
name | Displayed everywhere — use your real business name |
description | Tell clients what you do. 2–4 sentences is ideal |
category | Helps clients find you in search |
address | Required if you have a physical location |
phone | Clients want to call before booking |
website | Builds credibility |
logo | Shown in search results and the booking page |
cover_image | First impression on your profile page |
working_hours | Shown on the profile so clients know when you're open |
Tips:
- Write a description that focuses on client benefits, not just service names
- Use a high-quality square logo (at least 200×200px)
- Fill in all social links you actively use
Publishing your profile
Your profile starts as a draft — invisible to the public. Once it's ready:
POST /api/org/organization-profile/toggle-publish
Authorization: Bearer your-token
Step 2: Branches (Locations)
If you have one or more physical locations, create them as branches.
POST /api/org/branches
Authorization: Bearer your-token
Content-Type: application/json
{
"name": "Main Branch",
"address": "123 Main St, Tashkent",
"phone": "+998901234567"
}
Even if you only have one location, create it — appointments are linked to branches.
Step 3: Services
Services are what clients book. Create at least one service to get started.
POST /api/org/services
Authorization: Bearer your-token
Content-Type: application/json
{
"name": "Haircut",
"description": "Classic haircut with styling",
"duration": 60,
"price": 50000,
"category_id": 1,
"buffer_time": 10
}
Key fields:
| Field | Description |
|---|---|
duration | Service duration in minutes |
price | Price in the smallest currency unit (e.g., tiyin) |
buffer_time | Gap added after the appointment (cleanup time) |
prepay_required | Whether payment is required at booking |
prepay_amount | Fixed deposit amount if prepay is required |
max_advance_days | How far ahead clients can book this service |
Tips:
- Set
buffer_timerealistically — it prevents back-to-back bookings without breathing room - Group related services under the same category
- If a service takes different durations for different staff, create separate variants
Step 4: Staff Members
Add your team. Each staff member gets their own schedule and can be assigned to specific services.
See Staff Management for the full guide.
Step 5: Schedule & Availability
Each staff member needs a working schedule before slots appear. Until a schedule is set, no slots are generated.
See Services & Scheduling for the full guide.
Step 6: Settings
Configure organization-level behavior:
GET /api/org/settings
PUT /api/org/settings
Important settings:
| Setting | Description | Recommendation |
|---|---|---|
booking_lead_time | Minimum hours before a slot can be booked | Set to 1–2 hours to avoid last-minute surprises |
max_advance_booking_days | How many days ahead clients can book | 30–60 days is standard |
appointment_auto_confirm | Auto-confirm new bookings | Enable if you don't need manual approval |
allow_guest_booking | Allow booking without client account | Enable for lower friction |
slot_interval | Minutes between slot start times | Match to your service duration |
cancellation_hours | Hours before appointment clients can cancel | 24–48 hours is typical |
Step 7: Payment Settings (optional)
If you want to collect payments at booking time, turn it on and set your deposit/refund policy — no Stripe account needed on your end.
See Stripe for setup instructions.
Step 8: Notification Settings
Configure which notifications are sent to clients and staff:
GET /api/org/notification-settings
PUT /api/org/notification-settings
Recommended notifications to enable:
- Appointment confirmation (client)
- Appointment reminder (client) — typically 24h and 1h before
- New appointment notification (staff)
- Cancellation notification (both)
Invite Code
Share your organization invite code with staff so they can join your workspace:
POST /api/org/invite-code/generate
Authorization: Bearer your-token
Staff use this code when registering or joining from an existing account.
Dashboard
Once set up, monitor your business from the dashboard:
GET /api/org/dashboard
Authorization: Bearer your-token
Returns metrics for today's appointments, upcoming bookings, revenue, and recent activity.