curl -X POST \
-H "X-API-KEY: your_api_key" \
-H "Content-Type: application/json" \
-d '{
"name": "Summer Launch Party",
"start": { "utc": "2026-07-15T18:00", "timezone": "America/New_York" },
"end": { "utc": "2026-07-15T22:00", "timezone": "America/New_York" },
"location": "Convention Center, New York",
"capacity": 250,
"ticket_price": 0
}' \
"https://www.gomry.com/api/v1/events"
{
"data": {
"id": "AbCdEfGhIjKlMnOpQrSt",
"name": "Summer Launch Party",
"status": "active",
"registration_status": "open",
"currency": "usd",
"capacity": 250,
"tickets_sold": 0,
"start": { "utc": "2026-07-15T22:00:00.000Z", "timezone": "America/New_York" },
"end": { "utc": "2026-07-16T02:00:00.000Z", "timezone": "America/New_York" },
"venue": { "name": "Convention Center, New York", "address": "Convention Center, New York", "city": null, "state": null, "country": null },
"created_at": "2026-05-24T10:00:00.000Z",
"updated_at": "2026-05-24T10:00:00.000Z"
}
}
{
"error": "end must be after start"
}
{
"error": "insufficient_scope",
"message": "This API key does not have 'write' access to 'events'.",
"required_scope": "events:write"
}
Events
Create Event
Create a new event in your organization
POST
/
events
curl -X POST \
-H "X-API-KEY: your_api_key" \
-H "Content-Type: application/json" \
-d '{
"name": "Summer Launch Party",
"start": { "utc": "2026-07-15T18:00", "timezone": "America/New_York" },
"end": { "utc": "2026-07-15T22:00", "timezone": "America/New_York" },
"location": "Convention Center, New York",
"capacity": 250,
"ticket_price": 0
}' \
"https://www.gomry.com/api/v1/events"
{
"data": {
"id": "AbCdEfGhIjKlMnOpQrSt",
"name": "Summer Launch Party",
"status": "active",
"registration_status": "open",
"currency": "usd",
"capacity": 250,
"tickets_sold": 0,
"start": { "utc": "2026-07-15T22:00:00.000Z", "timezone": "America/New_York" },
"end": { "utc": "2026-07-16T02:00:00.000Z", "timezone": "America/New_York" },
"venue": { "name": "Convention Center, New York", "address": "Convention Center, New York", "city": null, "state": null, "country": null },
"created_at": "2026-05-24T10:00:00.000Z",
"updated_at": "2026-05-24T10:00:00.000Z"
}
}
{
"error": "end must be after start"
}
{
"error": "insufficient_scope",
"message": "This API key does not have 'write' access to 'events'.",
"required_scope": "events:write"
}
Create Event
Creates a new event in your organization. A default “General Admission” ticket class is created automatically with the price (or free flag) from the request body so the event is immediately bookable. Requires theevents:write scope.
Idempotency
Pass anIdempotency-Key header (max 255 chars) to make POST retries safe. The first request executes the create; subsequent requests with the same key within 24 hours replay the original response verbatim — including the original status code — and add an Idempotent-Replay: true response header. Keys are scoped per API key, so two integrations can use the same key value without collision.
Two concurrent requests with the same key return 409 idempotent_request_in_progress to the second caller.
Request Body
string
required
Event name (max 200 chars).
object
required
object
required
string
required
Physical address, OR a virtual meeting URL (
https://...). When a URL
is provided the event is flagged as virtual and the URL is stored as
the meeting link.string
ISO-4217 currency code. Defaults to the organization’s currency.
integer
Maximum number of tickets that can be sold.
0 or omitted means unlimited.number
Price for the default General Admission ticket class.
0 or omitted means free.boolean
Whether registrations require organizer approval. Defaults to
false.boolean
Whether the event is hidden from public listings. Defaults to
false.boolean
Absorb the Gomry service fee into the ticket price instead of adding it at checkout.
Defaults to
false (the buyer pays the fee on top).Settable at create so the event is never briefly live at a price that includes the fee
on top — a price you never quoted, on a public page.This is the event-wide default. An individual ticket class can override it with its
own remove_service_fees, so one event can absorb the fee on some tiers and pass it on
for others — see Create Ticket Class.string
Long-form description shown on the event page.
string
Space the event belongs to. Defaults to
GENERAL.Response
Returns the created event with201 Created.
curl -X POST \
-H "X-API-KEY: your_api_key" \
-H "Content-Type: application/json" \
-d '{
"name": "Summer Launch Party",
"start": { "utc": "2026-07-15T18:00", "timezone": "America/New_York" },
"end": { "utc": "2026-07-15T22:00", "timezone": "America/New_York" },
"location": "Convention Center, New York",
"capacity": 250,
"ticket_price": 0
}' \
"https://www.gomry.com/api/v1/events"
{
"data": {
"id": "AbCdEfGhIjKlMnOpQrSt",
"name": "Summer Launch Party",
"status": "active",
"registration_status": "open",
"currency": "usd",
"capacity": 250,
"tickets_sold": 0,
"start": { "utc": "2026-07-15T22:00:00.000Z", "timezone": "America/New_York" },
"end": { "utc": "2026-07-16T02:00:00.000Z", "timezone": "America/New_York" },
"venue": { "name": "Convention Center, New York", "address": "Convention Center, New York", "city": null, "state": null, "country": null },
"created_at": "2026-05-24T10:00:00.000Z",
"updated_at": "2026-05-24T10:00:00.000Z"
}
}
{
"error": "end must be after start"
}
{
"error": "insufficient_scope",
"message": "This API key does not have 'write' access to 'events'.",
"required_scope": "events:write"
}