Venues

Create a new venue

Changed on

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

  • Base URL: https://api.session.services
  • URL: https://api.session.services/venues
  • Auth: API key in header x-tenant-id

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-10-17T08:46:46.696Z",
      "updatedAt": "2026-10-17T08:46:46.696Z",
      "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
      }
    }
  }
}

Changes

  • 84f157e4443aRevision changes
    • breaking

      the / response property's maxLength was unset from 500 for the response status

    • info

      the request property's maxLength was increased from 500 to 10000

    • info

      added the non-success response with the status