Skip to main content
POST
/
locations
/
create
Create Location
curl --request POST \
  --url https://api.swoogo.com/api/v1/locations/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data event_id=1464 \
  --data 'name=Main Hall' \
  --data capacity=100 \
  --data 'color=#FF0000' \
  --data use_event_address=0
{
  "id": 42,
  "name": "Main Hall",
  "capacity": 100,
  "color": "#FF0000",
  "use_event_address": false,
  "created_by": 12345,
  "created_at": "2022-06-26 14:30:00",
  "updated_by": 12345,
  "updated_at": "2022-06-26 14:30:00"
}

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"