Operation

Create Venue

POST/venues

Add a new venue to your organisation. Venues are where events happen. You'll typically create a venue once and then create multiple events at that location. After creating a venue, you'll usually want to set up one or more seating layouts to define how tickets are sold (general admission, reserved seating, etc.).

When to use this

Adding a new location to your organisation
Setting up a venue before creating events there
Importing venues from another system

Headers

Idempotency-KeystringOptional: Makes the write safe to retry. The first request with a key does the work and its response is stored for 24 hours; a repeat with the same key and the same request (method, path, query, X-Ticketlayer-Channel, TL-Version and body) gets that stored status and body back, marked `Idempotent-Replay: true`, without running again. The key is scoped to your organisation and your credential. The same key with a different request is 422 IDEMPOTENCY_KEY_REUSED; a repeat while the first is still running waits for it, then answers 409 IDEMPOTENT_REQUEST_IN_PROGRESS if it has not finished. Only a 2xx is stored: after an error the key is free again. Omit the header and the request behaves as it always has.

Body

accountId*stringAccount ID that owns this venue

name*stringVenue name

descriptionstringVenue description

status"active" | "archived"Venue status

streetAddressstringStreet address

citystringCity

countrystringCountry

▼coordinatesobjectGPS coordinates for mapping

longitude*numberLongitude (-180 to 180)

latitude*numberLatitude (-90 to 90)

timezonestringIANA timezone

phonestringContact phone number

emailstring (email)Contact email

websitestring (uri)Venue website

featuresstring[]Venue features and facilities

tagsstring[]Venue tags

Returns

Venue created successfully

Errors

400: Bad Request - Invalid input
401: Unauthorized - Authentication required
403: Forbidden - Insufficient permissions
404: Not Found - Resource not found
500: Internal Server Error

Every error names its code and links to it. All error codes

Notes

Note

You'll need the venue ID to create events at this location.

Tip

Add the full address to help customers find the venue and to enable map integration.

import { BackstageClient } from '@ticketlayer/backstage';const client = new BackstageClient({  organisationSlug: 'your-org',});client.setAccessToken('YOUR_ACCESS_TOKEN');// Create venueconst venue = await client.venue.create({  name: 'New Venue',  // Add other required fields});console.log(`Created venue with ID: ${venue.id}`);

Response 201

{
  "venue": {
    "id": "vnu_abc123",
    "organisationId": "org_xyz789",
    "accountId": "acc_def456",
    "name": "Royal Albert Hall",
    "description": "Historic concert hall in London",
    "status": "active",
    "streetAddress": "Kensington Gore",
    "country": "United Kingdom",
    "coordinates": {
      "type": "Point",
      "coordinates": [
        -0.1278,
        51.5074
      ]
    },
    "timezone": "Europe/London",
    "phone": "+44 20 7589 8212",
    "email": "info@royalalberthall.com",
    "website": "https://www.royalalberthall.com",
    "features": [
      "parking",
      "wheelchair_accessible",
      "bar"
    ],
    "tags": [
      "concert-hall",
      "historic"
    ],
    "isDeleted": false,
    "createdAt": "2024-12-28T10:30:00Z",
    "updatedAt": "2024-12-28T14:45:00Z",
    "createdBy": "usr_abc123"
  }
}

Create Venue

When to use this

Headers

Body

Returns

Errors

Notes

Related

Try it in test mode

Body