Setting Up Centres
How to create and configure your hospital locations in Hospital OS.
Setting Up Centres
A centre represents a physical hospital location or clinic branch. Each centre has its own address, timezone, operating hours, and holiday calendar. All appointments, staff assignments, and billing are scoped to a specific centre.
Creating a Centre
When you add a new centre, you provide the following details:
- Name: the display name of the hospital or clinic (e.g., 'City Hospital Main Branch')
- Code: a unique business identifier per tenant (e.g., 'CITY-MAIN-001'). This code cannot be reused across centres within the same tenant
- Timezone: the IANA timezone for the centre (defaults to Asia/Kolkata). All time calculations for slots, appointments, and working hours are based on this timezone
- Address: the full postal address including optional geolocation coordinates
Centre Address Fields
The address structure includes:
Field | Required | Description |
|---|---|---|
Street Line 1 | Yes | Primary street address |
Street Line 2 | No | Apartment, suite, or floor |
City | Yes | City name |
State | Yes | State or province |
Pincode | Yes | Postal or ZIP code |
Country | Yes | Country name |
Latitude | No | GPS latitude for map integration |
Longitude | No | GPS longitude for map integration |
Centre Status
Each centre has an active/inactive status:
- Active: centre is operational — staff can be assigned, appointments can be booked, and slots are generated
- Inactive: centre is hidden from booking flows. Existing appointments remain but no new ones can be created
Deactivating a centre does not cancel existing appointments. It only prevents new bookings at that location.
Centre Timezone
The timezone determines how operating hours and appointment times are interpreted. For example, if the centre timezone is Asia/Kolkata, a working hour of 540 minutes (9:00 AM) means 9:00 AM IST.
The timezone is used during slot generation to correctly calculate appointment start and end times in epoch seconds. All stored times use epoch seconds (UTC), and the timezone is applied when displaying or computing local times.
Managing Centre Details
After creating a centre, you can update its name, address, timezone, and status at any time. The centre code cannot be changed after creation.
To view all centres, use the list endpoint which supports pagination. You can also retrieve a single centre by its UUID.
What Centres Control
Centres are the organizational anchor for the system. Here is what is scoped to a centre:
- Departments and sub-departments
- Resources (rooms, equipment)
- Staff assignments (doctors assigned to centres)
- Working hours and holiday calendars
- Appointment slots (generated per centre per doctor)
- Walk-in token queues
- Bills and invoices
- Notification routing rules (can be centre-specific or tenant-wide)
Last updated on