Skip to content

Create a Location

POST
/businesses/{businessId}/locations

Create a new location for the business.

businessId
required
string format: uuid

Business ID

Location Create Input
object
name
required

Name of the location.

string
description

Description of the location.

string
instructions

Instructions for the location.

string
address

Address of the location.

string
lat

Latitude of the location.

number format: float
lng

Longitude of the location.

number format: float
timezone

Timezone of the location.

string
phone

Phone number for the location.

string
Example
+15555555555
pictureId

ID of the picture uploaded via file upload API.

string
email

Email address for the location.

string format: email

The created location.

object
data
Location

A physical or virtual location where services can be provided

object
id
required

Unique identifier across the platform.

string format: uuid
name
required

The name of the location

string
Example
Downtown Office
description

A description of the location

string
nullable
Example
Our main office in the city center
instructions

Instructions for finding or accessing the location

string
nullable
Example
Enter through the main entrance and take the elevator to the 5th floor
address

The physical address of the location

string
nullable
Example
123 Main St, New York, NY 10001
lat

Latitude of the location

number format: float
nullable
lng

Longitude of the location

number format: float
nullable
timezone

The timezone of the location

string
Example
America/New_York
phone

Phone number of the location

string
nullable
email

Email address of the location

string format: email
nullable
pictureUrl

URL of the location’s picture

string format: uri
nullable
services

Services offered at the location

Array<object>
object
id

Unique identifier across the platform.

string format: uuid
name

Name of the service

string
createdAt

Timestamp of when the location was created

string format: date-time
updatedAt

Timestamp of when the location was last updated

string format: date-time

Location requires authentication

object
error
object
code
number
Example
404
title
string
Example
Not Found

Location not found

object
error
object
code
number
Example
404
title
string
Example
Not Found