Skip to main content
POST
/
venues
Create a venue
curl --request POST \
  --url https://api.nuwebgroup.com/v1/venues \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Smith Square",
  "address": "Cambridge Road",
  "city": "Yorkshire",
  "region": "Yorkshire",
  "postcode": "YO7 1AB",
  "countryId": 225,
  "latitude": "52.123131",
  "longitude": "0.1231231",
  "capacity": 25000
}
'
{
  "data": {
    "type": "venues",
    "id": 1,
    "attributes": {
      "externalId": "VNU-312",
      "name": "O2 Arena",
      "address": "Peninsula Square",
      "city": "London",
      "region": "London",
      "postcode": "SE10 0DX",
      "latitude": "51.503038",
      "longitude": "0.0031543",
      "capacity": 20000,
      "createdAt": "2023-09-14T00:00:00.000000Z",
      "updatedAt": "2023-09-14T00:00:00.000000Z",
      "deletedAt": null
    },
    "relationships": {
      "cities": {
        "data": {
          "type": "cities",
          "id": 1
        }
      }
    }
  },
  "included": [
    {
      "type": "cities",
      "id": 1,
      "attributes": {
        "name": "London",
        "region": "Greater London",
        "country": "United Kingdom"
      }
    }
  ]
}

Authorizations

Authorization
string
header
required

The 'Bearer' token can be obtained from the token management interface or via the login endpoint using your admin user credentials.

Body

application/json

Request body for creating a venue.

name
string
required

The name of the venue.

address
string
required

The first line of the address.

city
string
required

The city of the venue.

region
string
required

The region of the venue.

postcode
string

The postcode of the venue.

countryId
string

The country of the venue. Country ID's can be found via the Retrieve Countries endpoint.

latitude
string

The latitude of the venue address.

longitude
string

The longitude of the venue address.

capacity
integer

The total capacity of the venue.

Response

Successful request to fetch venues.

data
object

The ID of the company the venue belongs to.

included
any[]

An array of included relationship resources.