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

Documentation Index

Fetch the complete documentation index at: https://docs.nuwebgroup.com/llms.txt

Use this file to discover all available pages before exploring further.

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.

Headers

​
X-NU-COMPANY-ID
integer

The ID of the company this operation should be performed against.

​
Accept-Language
string

Sets the preferred language for localised response content (e.g. en, fr, de). If the requested language is not supported by the company, the company fallback language will be assumed.

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
object[]

An array of included relationship resources.