---
title: "Create an event"
method: POST
path: "/v1/events"
tags: ["Events"]
---

# Create an event

`POST /v1/events`

## Request body

- CreateEventDto
  - `name` string, required — Event title.
  - `formattedLocations` string[] — Candidate locations. Each entry needs a `city`.
  - `eventDates` string[] — Inclusive date ranges, YYYY-MM-DD.
  - `venueType` string — Venue type. Defaults to 'hotel'.
  - `numPeople` number — Total attendees.
  - `numHotelRoomsNeeded` number — Guestrooms needed.
  - `meetingRooms` string — Free-text meeting-room requirement.
  - `foodBeverageRequirements` string — Free-text food and beverage needs.
  - `currency` string — ISO currency code. Defaults to 'USD'.
  - `organizationId` number — 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.

## Response `201`

The created event's id

## Other responses

- `400` — Malformed field
- `401` — Missing or invalid API key
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/nowadays/apis/nowadays-public-api.md) · [All operations](https://skmtc.dev/nowadays/apis/nowadays-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nowadays/nowadays-public-api/revisions/d52c99b95372/schema)