Skip to main content
POST
/
v1
/
venues
Error
A valid request URL is required to generate request examples
{
  "name": "Downtown Event Center",
  "address": {},
  "label": "downtown-event-center",
  "type": "coworking",
  "spaces": [
    "<array>"
  ],
  "openingHours": [
    {
      "day": "monday",
      "open": "09:00",
      "close": "18:00"
    },
    {
      "day": "tuesday",
      "open": "09:00",
      "close": "18:00"
    }
  ],
  "metadata": {
    "import": "calendarId",
    "googleCalendarId": "primary"
  },
  "medias": [
    "<array>"
  ]
}

Authorizations

​
Authorization
string
header
required

OAuth2 authentication for Boseat API

Body

application/json
​
name
string
required

Display name of the venue. This is the public-facing name shown to users.

Example:

"Downtown Event Center"

​
label
string
required

URL-friendly slug used to identify the venue in URLs and API calls. Must be unique within the organization. Typically lowercase with hyphens.

Example:

"downtown-event-center"

​
type
enum<string>
required

Type of venue, which determines available features and booking rules. Different venue types may have different space configurations and product options.

Available options:
coworking,
hotel,
event_space,
sports_facility,
podcast_studio,
meeting_center,
conference_center,
restaurant,
retail_space,
generic
Example:

"event_space"

​
address
object
required

Physical address of the venue including street, city, postal code, and country. Used for location display and mapping.

​
openingHours
object[]
required

Operating hours for the venue. Defines when the venue is open for bookings. Must include at least one day. Each day specifies opening and closing times.

Example:
[
  {
    "day": "monday",
    "open": "09:00",
    "close": "18:00"
  },
  {
    "day": "tuesday",
    "open": "09:00",
    "close": "18:00"
  }
]
​
metadata
object

Additional metadata for the venue. Can include integration-specific data like calendar IDs, external system references, or custom configuration.

Example:
{
  "import": "calendarId",
  "googleCalendarId": "primary"
}

Response

Venue successfully created and returned with all details including spaces and media

​
name
string
required

Display name of the venue

Example:

"Downtown Event Center"

​
address
object
required

Physical address of the venue including street address, city, postal code, and country

​
label
string
required

URL-friendly slug used to identify the venue. Used in URLs and API calls.

Example:

"downtown-event-center"

​
type
enum<string>
required

Type of venue, which determines available features, space configurations, and booking rules

Available options:
coworking,
hotel,
event_space,
sports_facility,
podcast_studio,
meeting_center,
conference_center,
restaurant,
retail_space,
generic
Example:

"coworking"

​
spaces
array[]
required

List of spaces available within this venue. Each space can be booked independently and may have different capacities and features.

​
openingHours
object[]
required

Operating hours for the venue, defining when bookings are available. Each entry specifies a day of the week with opening and closing times.

Example:
[
  {
    "day": "monday",
    "open": "09:00",
    "close": "18:00"
  },
  {
    "day": "tuesday",
    "open": "09:00",
    "close": "18:00"
  }
]
​
metadata
object
required

Additional metadata for the venue. May include integration data, external system references, or custom configuration.

Example:
{
  "import": "calendarId",
  "googleCalendarId": "primary"
}
​
medias
array[]
required

Media files (images, videos) associated with the venue. Used for display in booking interfaces and marketing materials.