Skip to main content
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"
  }
}

​
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 the events:write scope.

​
Idempotency

Pass an Idempotency-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

​
name
string
required
Event name (max 200 chars).
​
start
object
required
​
end
object
required
​
location
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.
​
currency
string
ISO-4217 currency code. Defaults to the organization’s currency.
​
capacity
integer
Maximum number of tickets that can be sold. 0 or omitted means unlimited.
​
ticket_price
number
Price for the default General Admission ticket class. 0 or omitted means free.
​
require_approval
boolean
Whether registrations require organizer approval. Defaults to false.
​
is_private
boolean
Whether the event is hidden from public listings. Defaults to false.
​
description
string
Long-form description shown on the event page.
​
space_identifier
string
Space the event belongs to. Defaults to GENERAL.

​
Response

Returns the created event with 201 Created.
​
data
object
Same schema as Get Event.
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"
  }
}