Skip to main content
POST
Create Location

Authorizations

Authorization
string
header
required

OAuth 2.0 bearer token obtained from POST /oauth2/token. Tokens expire after 30 minutes. Include in the Authorization header as Bearer {access_token}.

Body

application/x-www-form-urlencoded
event_id
integer
required

ID of the event this location belongs to.

Example:

1464

name
string
required

Display name of the location.

Maximum string length: 255
Example:

"Main Hall"

capacity
integer

Maximum number of attendees the location can hold.

Example:

100

color
string

Hex colour code (including the leading #) used when rendering sessions assigned to this location.

Maximum string length: 7
Example:

"#FF0000"

use_event_address
enum<integer>

1 when the location reuses the event's address (no standalone address is created); 0 to use the location's own address. Defaults to 1 when omitted. Only 0 and 1 are accepted — true/false will be rejected with a 422 validation error.

Available options:
0,
1
Example:

0

Response

Location created

id
integer
Example:

42

name
string
Example:

"Main Hall"

capacity
integer | null
Example:

100

color
string | null
Example:

"#FF0000"

use_event_address
boolean
Example:

false

created_by
integer

ID of the user who created the location.

Example:

12345

created_at
string
Example:

"2022-06-26 14:30:00"

updated_by
integer

ID of the user who last updated the location.

Example:

12345

updated_at
string
Example:

"2022-06-26 14:30:00"