---
title: "Create a new event."
method: POST
path: "/api/v2/organizations/{orgSlug}/events"
tags: ["Events"]
---

# Create a new event.

`POST /api/v2/organizations/{orgSlug}/events`

## Request

- Base URL: `https://app.officernd.com`
- URL: `https://app.officernd.com/api/v2/organizations/{orgSlug}/events`
- Auth: OAuth 2
  - Authorization code: `https://identity.officernd.com/auth/authorize`
  - Client credentials
  - Token URL: `https://identity.officernd.com/auth/token` scopes: `flex.collaboration.events.create`

Create a new event. 

 Required scopes: `flex.collaboration.events.create`

## Path parameters

- `orgSlug` string, required

## Request body

- AddEventDto
  - `title` string, required: The title of the event.
  - `location` string, required: The location of the event.
  - `start` string, required: The start date of the event.
  - `end` string, required: The end date of the event.
  - `links` string[]: An array containing all the links associated with the events.
  - `description` string: The description of the event.
  - `where` string: A description of where the event will be taking place.
  - `limit` number: The number of participants that this event will host.
  - `company` string: The _id of the company that will be associated with the event.
  - `image` string: The image link associated with the event.
  - `timezone` string: The timezone of the event.

## Response `201`

- EventResultDto
  - `_id` string: The _id of the event.
  - `start` string: The start date of the event.
  - `end` string: The end date of the event.
  - `timezone` string: The timezone of the event.
  - `title` string: The title of the event.
  - `location` string: The _id of the location of the event.
  - `locations` string[]: The ids of the locations where the event is visible.
  - `description` string: The description of the event.
  - `where` string: A description of where the event will be taking place.
  - `company` string: The _id of the company that will be associated with the event.
  - `member` string: The _id of the member who created the event.
  - `limit` number: The number of participants that this event will host.
  - `links` string[]: An array containing all the links associated with the events.
  - `image` string: The image link associated with the event.

---

[API](https://skmtc.dev/officernd/apis/collaboration-api.md) - [All operations](https://skmtc.dev/officernd/apis/collaboration-api/llms.txt) - [OpenAPI document](https://skmtc.dev/officernd/apis/collaboration-api/revisions/f868beae3384?raw)