Skip to main content
POST
Add a location to an Event

Headers

Authorization
string
required

value must be Bearer <token> where <token> is api key prefixed with cal_, managed user access token, or OAuth access token

Path Parameters

uuid
string<uuid>
required

Event UUID. Accepts the canonical UUID (e.g. 018ff5cd-6dc4-7d57-bcbc-374702ca8b38) or its short-uuid (Flickr Base58) form (e.g. 1cbZYoAFoJdwqN4tixezd5).

Body

application/json
type
enum<string>
required
Available options:
address
Example:

"address"

address
string
required
Minimum string length: 1
Example:

"1 Example Street, Berlin"

label
string

Name shown for this location.

Maximum string length: 100
price
number

Price for this location, in the currency's smallest unit.

Required range: x >= 1
Example:

1500

currency
enum<string>

Cal Pay currency code. Required when price is set.

Available options:
usd,
eur,
gbp,
cad,
aud,
chf,
nzd,
jpy,
brl,
mxn,
inr,
sgd,
hkd,
dkk,
nok,
sek,
pln,
czk,
huf,
ron,
bgn,
krw,
thb,
php,
myr,
idr,
try,
zar,
aed,
cop
Example:

"usd"

capacity
number

Seats at this location. Omit for unlimited. All locations together can have at most 100000 seats.

Required range: 1 <= x <= 100000

Response

status
enum<string>
required
Available options:
success,
error
Example:

"success"

data
Address · object
required