Sign in

v11

latestOpenAPI 3.1.12026-08-03174162.0 MB
Venues

Create a new venue

Create a new venue. Venue will be owned by the specified team but can be used by all teams for their events

post/venues

Request body

teamIdstring required

Team that manages this venue

locationIdstring required

Location identifier for this venue

namestring required

Display name of the venue. Must be between 3 and 100 characters

slugstring

URL-friendly slug for the venue. If not provided, will be automatically generated from the name. Must be unique within tenant

descriptionstring

Short description of the venue for listings and discovery

capacityinteger

Maximum capacity of the venue (number of attendees)

metadataobject

Flexible key-value metadata storage for custom configuration. Similar to Stripe's metadata API. Maximum 50 keys, key names up to 40 characters, values up to 500 characters.

Example request

{
  "locationId": "loc_01h2xk3j9k8m2n5p7q9r1s3t4v",
  "image": {
    "src": "https://assets.session.services/my-image.jpg",
    "alt": "My Image",
    "width": 1080,
    "height": 1080
  }
}

Response

OK

Example response

{
  "venue": {
    "locationId": "loc_01h2xk3j9k8m2n5p7q9r1s3t4v",
    "googlePlaceId": "ChIJP3Sa8ziYEmsRUKgyFmh9AQM",
    "approval": "APPROVED",
    "image": {
      "src": "https://assets.session.services/my-image.jpg",
      "alt": "My Image",
      "width": 1080,
      "height": 1080
    },
    "location": {
      "id": "loc_01hk153x00eh99pagyydz03sbz",
      "googlePlaceId": "ChIJP3Sa8ziYEmsRUKgyFmh9AQM",
      "createdAt": "2026-08-03T06:13:52.214Z",
      "updatedAt": "2026-08-03T06:13:52.214Z",
      "name": "Watson's EQ",
      "address": "The, Entertainment Quarter, 1 Bent St, Moore Park NSW 2021, Australia",
      "city": "Moore Park",
      "state": "New South Wales",
      "postcode": "2021",
      "country": "Australia",
      "latitude": -33.8944593,
      "longitude": 151.2252255,
      "timeZone": "Australia/Sydney",
      "types": [
        "establishment",
        "point_of_interest",
        "stadium"
      ],
      "description": "Historic outdoor amphitheater known for summer concerts",
      "image": {
        "src": "https://assets.session.services/my-image.jpg",
        "alt": "My Image",
        "width": 1080,
        "height": 1080
      }
    }
  }
}