v1

latestOpenAPI 3.0.02026-07-22469.0 KB

Events

Create an event

post/v1/events

Request body

namestring required

Event title.

formattedLocationsstring[]

Candidate locations. Each entry needs a city.

eventDatesstring[]

Inclusive date ranges, YYYY-MM-DD.

venueTypestring

Venue type. Defaults to 'hotel'.

numPeoplenumber

Total attendees.

numHotelRoomsNeedednumber

Guestrooms needed.

meetingRoomsstring

Free-text meeting-room requirement.

foodBeverageRequirementsstring

Free-text food and beverage needs.

currencystring

ISO currency code. Defaults to 'USD'.

organizationIdnumber

The organization to create the event under; must be one the acting user belongs to. Ignored on the developer API, where the key already binds an organization.

Example request

{
  "name": "Annual Summit",
  "formattedLocations": [
    {
      "city": "Austin"
    }
  ],
  "eventDates": [
    {
      "startDate": "2027-03-15",
      "endDate": "2027-03-17"
    }
  ]
}

Response

The created event's id