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.object
The same place as
location, structured. Optional and additive — location
stays required and remains the display line.Supply this when you know the parts. Events are grouped by city on discovery
pages and need coordinates to appear on a map, and neither can be recovered
from a single formatted address string.Show child attributes
Show child attributes
string
Venue name (max 200 chars).
string
Street address (max 500 chars).
string
City (max 120 chars). Used to group the event on discovery pages.
string
State or region (max 120 chars).
string
Country (max 120 chars).
string
Postal code (max 32 chars).
number
Between -90 and 90. Required, with
longitude, to place the event on a map.number
Between -180 and 180.
string
Google Place ID (max 256 chars) — the most durable way to identify a venue.
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
Cover image URL for the event page banner (max 2,000 chars). Must already be
hosted — use Upload Image to upload
bytes and get a URL back.Settable at create so the event is never briefly public wearing a platform
placeholder — the same reason
remove_service_fees is accepted here. Omit it
and Gomry assigns one of its own cover photos.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"
}