# Create event

`POST /events`

Base URL: `https://api.viewcy.com/2025_06`

## Request Body

Content-Type: `application/json`

- `name` (string)
- `category` (string)
- `description` (string)
- `timezone` (string)
- `registrationLimit` (integer)
- `bookText` (string)
- `tags` (array)
- `location` (object)
  - `name` (string)
  - `address` (string)
  - `city` (string)
  - `country` (string)
  - `state` (string)
  - `zipcode` (string)
- `occurrences` (array)
  Items:
    - `startsAt` (string)
    - `endsAt` (string)
- `collectInformationSetting` (string)
- `refundsAllowed` (boolean)
- `orderAnswersEditable` (boolean)
- `slug` (string)
- `doorTimeMinutes` (integer)
- `showOccurrencesAsSeparateEvents` (boolean)
- `guestEmailMessage` (string)
- `donorEmailMessage` (string)
- `imageIds` (array)
- `featuredImageId` (string)

## Responses

### 201 — Creates a draft event

- `object` (string)
- `id` (string)
- `slug` (string)
- `name` (string)
- `description` (string)
- `category` (string)
- `status` (string)
- `visibility` (string)
- `accessMode` (string)
- `timezone` (string)
- `locationSetting` (string)
- `hideAddressUntilPurchase` (boolean)
- `featuredVideoUrl` (any)
- `bookText` (string)
- `collectInformationSetting` (string)
- `refundsAllowed` (boolean)
- `orderAnswersEditable` (boolean)
- `doorTimeMinutes` (integer)
- `showOccurrencesAsSeparateEvents` (boolean)
- `tags` (array)
- `registrationLimit` (integer)
- `currency` (string)
- `featuredImageUrl` (string)
- `images` (array)
- `theme` (string)
- `seatsEventKey` (any)
- `likeCount` (integer)
- `url` (string)
- `createdAt` (string)
- `updatedAt` (string)
- `meta` (object)
  - `requestId` (string)

### 401 — Returns 401

- `object` (string)
- `status` (integer)
- `message` (string)
- `meta` (object)
  - `requestId` (string)

### 403 — Creates a draft event

- `object` (string)
- `status` (integer)
- `message` (string)
- `meta` (object)
  - `requestId` (string)

### 422 — Creates a draft event

- `object` (string)
- `status` (integer)
- `message` (string)
- `errors` (array)
  Items:
    - `field` (string)
    - `message` (string)
- `meta` (object)
  - `requestId` (string)

---
Full OpenAPI spec: https://developer.viewcy.com/openapi/2025_06_viewcy_api.yaml

Interactive docs: https://developer.viewcy.com/api/create-event