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

# Create an event

`POST /events`

## Request

- Base URL: `https://api.livestorm.co/v1`
- URL: `https://api.livestorm.co/v1/events`
- Auth: one of:
  - API key in header `Authorization`
  - OAuth 2
    - Authorization code: `https://app.livestorm.co/oauth/authorize`
    - Token URL: `https://app.livestorm.co/oauth/token`

Create a new event or duplicate an existing one.

## Request body

- object
  - `data` object
    - `type` string
    - `attributes` object
      - `copy_from_event_id` string
      - `owner_id` string
      - `title` string
      - `slug` string
      - `status` string
      - `everyone_can_speak` boolean
      - `detailed_registration_page_enabled` boolean
      - `light_registration_page_enabled` boolean
      - `description` string
      - `recording_enabled` boolean
      - `recording_public` boolean
      - `show_in_company_page` boolean
      - `chat_enabled` boolean
      - `questions_enabled` boolean
      - `polls_enabled` boolean
    - `relationships` object
      - `sessions` object[]
        - `type` string
        - `attributes` object
          - `estimated_started_at` string
          - `timezone` string

## Response `201`

Created

- object
  - `data` object, required: Data
    - `id` string: ID
    - `type` string: Type
    - `attributes` object: Attributes
      - `title` string
      - `slug` string
      - `status` string
      - `detailed_registration_page_enabled` boolean
      - `light_registration_page_enabled` boolean
      - `recording_enabled` boolean
      - `recording_public` boolean
      - `recording_source` string
      - `recording_custom_video_media` object
        - `file_type` string
        - `mime_type` string
        - `file_size` integer
        - `file_name` string
        - `url` string
        - `url_generated_at` integer
        - `url_expires_in` integer
      - `show_in_company_page` boolean
      - `chat_enabled` boolean
      - `questions_enabled` boolean
      - `polls_enabled` boolean
      - `registration_link` string
      - `estimated_duration` integer
      - `registration_page_enabled` boolean
      - `everyone_can_speak` boolean
      - `description` string
      - `language` string
      - `published_at` integer
      - `created_at` integer
      - `updated_at` integer
      - `owner` object
      - `sessions_count` integer
      - `fields` object[]
        - `id` string
        - `type` string
        - `order` integer
        - `required` boolean

## Other responses

- `400`: Bad request
- `401`: Authentication failed
- `402`: Active contacts allowance reached. To add more registrants, please upgrade your plan
- `403`: Workspace blocked
- `422`: Team member not found
- `429`: Too Many Requests

---

[API](https://skmtc.dev/livestorm/apis/livestorm-public-api.md) - [All operations](https://skmtc.dev/livestorm/apis/livestorm-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/livestorm/apis/livestorm-public-api/revisions/9292f597e878?raw)