Quickstart

Base URL

All examples in these docs use:

https://api.bronjoy.com/api

1. Create an account

If you don't have a Bronjoy business account yet, register one:

POST https://api.bronjoy.com/api/org/auth/register
Content-Type: application/json

{
  "name": "Jane Smith",
  "email": "[email protected]",
  "password": "secret"
}

Verify the email code you receive, and the response gives you a Bearer token. Full details in Authentication.

2. Create an organization

A user can own or join one or more organizations. Create one:

POST https://api.bronjoy.com/api/org/organizations
Authorization: Bearer your-token
Content-Type: application/json

{
  "business_name": "Downtown Barbershop",
  "slug": "downtown-barbershop"
}

slug is your booking page handle (bronjoy.com/downtown-barbershop) — pick something short and unique. The response includes the organization id — you'll need it for every request below.

3. Set your organization context

Every request under /api/org/... needs to know which organization you're operating on. Send it as a header on every request:

X-Organization-ID: 1

4. Make your first request

Check your setup checklist:

GET https://api.bronjoy.com/api/org/setup-status
Authorization: Bearer your-token
X-Organization-ID: 1

Or list your services (empty until you create one — see Organization Setup):

GET https://api.bronjoy.com/api/org/services
Authorization: Bearer your-token
X-Organization-ID: 1

Next steps

• Authentication — full auth flows for staff and clients, and how to mint scoped API tokens
• Organization Setup — complete setup checklist so your business can take bookings
• Booking Flow — how a client books an appointment end-to-end
• MCP Integration — connect an AI client to your organization
• API Reference — every endpoint, request, and response shape