Skip to main content
POST
Create an event

Authorizations

Authorization
string
header
required

ts-{uuid}-{secret}. Every key requires its independent secret.

Body

application/json
title
string
required
Required string length: 1 - 200
Example:

"Developer Conference"

start_date
string<date>
required
Example:

"2026-11-15"

end_date
string<date>
required
Example:

"2026-11-15"

timezone
string
required

Valid IANA timezone. Nonexistent local times are rejected.

Example:

"America/Los_Angeles"

description
string

Sanitized HTML event description.

Maximum string length: 50000
start_time
string
Pattern: ^([01][0-9]|2[0-3]):[0-5][0-9]$
Example:

"09:00"

end_time
string
Pattern: ^([01][0-9]|2[0-3]):[0-5][0-9]$
Example:

"17:00"

venue
object
hostName
string
Maximum string length: 200
image
string

Direct public HTTPS URL (no redirects, private addresses, credentials or custom ports), or base64 data URL for JPEG, PNG, WebP or GIF. Maximum decoded size 5 MiB; images are validated and converted to JPEG.

status
enum<string>
default:live
Available options:
draft,
live
tickets
object[]
Maximum array length: 50

Response

Event created. Inspect warnings if a ticket could not be created; do not retry event creation.

success
boolean
event
object
tickets
object[]
warnings
object[]