Sign in

v11

latestOpenAPI 3.1.12026-08-03174162.0 MB
Venues

Link location to venue

Link a location to this venue. Allows the venue to be discovered when users search for this location. A venue can have multiple linked locations (e.g., different addresses, branded names). Requires venue access on the owning team (for example, venue.write).

post/venues/{key}/locations

Path parameters

keystring required

Venue key - either a unique ID (ven_xxx format) or URL-friendly slug

Example:ven_01jqpjksnsen9vprw95et60t2m

Request body

locationKeystring required

Location ID (loc_xxx) or Google Place ID to link to this venue

Example request

{
  "locationKey": "loc_01jps5cgsm7qxvh6watsons0eq"
}

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
      }
    }
  }
}