Locations
Create & Update Locations
The Location API enables you to create and manage physical locations in your organization. When you create a location, we automatically generate a location cache object to provide fast access to essential location data.
Create Location
POST
`/v1/locations`
You only need a name
and address
to create a location. To view all of the properties, check the Update Location section below.
Required Payload
- name
string
- address
string|object
Optional Payload
Default Values
When creating a new location:
- Operating hours default to Monday-Friday, 9 AM - 5 PM
- The location is assigned to both the creating user and all users with the owner role in the organization.
- A default layout is created
- Notification settings initialize with default configurations
- Service levels include all available options by default
Plan Limitations
Location creation is subject to plan limits:
- Free plan: Maximum of 2 locations
- Professional plan: Maximum of 5 locations
- Enterprise plan: Unlimited locations
Example Request
Update Location
POST
`/v1/locations/:location`
Updates an existing location's attributes using the id
of the location.
Path Parameters
location_id
(required): The unique identifier of the location to update, prefixed withloc_