Service LocationsVersion: v3

Create Service Location

POST/calendars/services/locations

Create a new service location

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:calendars.write

Auth methods:OAuthPrivate Integration

Token type:Sub-Account Token

Request

Headers

Versionstringrequired

API Version

Available optionsv3

Example:v3

Body

application/json

locationIdstringrequired

Location ID

Example:0007BWpSzSwfiuSl0tR2

namestringrequired

Location name

Example:Midtown Therapy Studio

slugstringrequired

URL-friendly slug identifier

Example:midtown-therapy-studio

phonestring

Phone number

Example:+1-212-555-0174

addressstring

Use a full street address when locationType is offline. Use a user-facing label when locationType is ask_booker.

Example:789 5th Avenue, Floor 3, New York, NY 10022 / Home Service

coverImagestring

URL of the cover image for this service location

Example:https://storage.example.com/locations/midtown-therapy-studio/cover.jpg

locationTypestring

Location type

Available optionsofflineask_booker

Example:offline

Response

application/json

Service location created successfully

idstringrequired

Service Location ID

Example:65e5f6dfacf123513228d384

locationIdstringrequired

Location ID

Example:0007BWpSzSwfiuSl0tR2

namestringrequired

Location name

Example:Downtown Wellness Center

slugstringrequired

Unique URL-friendly identifier for the service location

Example:downtown-wellness-center

isActiveboolean

Whether location is active

Default:true

Example:true

isPrivateboolean

Whether location is private (not shown publicly)

Default:false

Example:false