---
title: "Create Event by Group ID"
method: POST
path: "/team-messaging/v1/groups/{groupId}/events"
tags: ["Calendar Events"]
---

# Create Event by Group ID

`POST /team-messaging/v1/groups/{groupId}/events`

Creates a new calendar event within the specified group.

## Path parameters

- `groupId` string, required

## Request body

- TMCreateEventRequest
  - `id` string — Internal identifier of an event
  - `creatorId` string — Internal identifier of a person created an event
  - `title` string, required — Event title
  - `startTime` string, date-time, required — Datetime of starting an event
  - `endTime` string, date-time, required — Datetime of ending an event
  - `allDay` boolean — Indicates whether event has some specific time slot or lasts for whole day(s)
  - `recurrence` EventRecurrenceInfo
    - `schedule` 'None' | 'Day' | 'Weekday' | 'Week' | 'Month' | 'Year' — Event recurrence settings. For non-periodic events the value is `None`. Must be greater or equal to event duration: 1- Day/Weekday; 7 - Week; 28 - Month; 365 - Year
    - `endingCondition` 'None' | 'Count' | 'Date' — Condition of ending an event
    - `endingAfter` integer — Count of event iterations. For periodic events only. Value range is 1 - 10. Must be specified if `endingCondition` is `Count`
    - `endingOn` string, date-time — Iterations ending datetime for periodic events in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format
  - `color` 'Black' | 'Red' | 'Orange' | 'Yellow' | 'Green' | 'Blue' | 'Purple' | 'Magenta' — Color of Event title (including its presentation in Calendar)
  - `location` string — Event location
  - `description` string — Event details

## Response `200`

Success

- TMEventInfo
  - `id` string — Internal identifier of an event
  - `creatorId` string — Internal identifier of a person created an event
  - `title` string — Event title
  - `startTime` string, date-time — Datetime of starting an event
  - `endTime` string, date-time — Datetime of ending an event
  - `allDay` boolean — Indicates whether an event has some specific time slot or lasts for the whole day(s)
  - `recurrence` EventRecurrenceInfo
    - `schedule` 'None' | 'Day' | 'Weekday' | 'Week' | 'Month' | 'Year' — Event recurrence settings. For non-periodic events the value is `None`. Must be greater or equal to event duration: 1- Day/Weekday; 7 - Week; 28 - Month; 365 - Year
    - `endingCondition` 'None' | 'Count' | 'Date' — Condition of ending an event
    - `endingAfter` integer — Count of event iterations. For periodic events only. Value range is 1 - 10. Must be specified if `endingCondition` is `Count`
    - `endingOn` string, date-time — Iterations ending datetime for periodic events in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format
  - `color` 'Black' | 'Red' | 'Orange' | 'Yellow' | 'Green' | 'Blue' | 'Purple' | 'Magenta' — Color of Event title (including its presentation in Calendar)
  - `location` string — Event location
  - `description` string — Event details

## Other responses

- `400` — Some of the parameters are missing or have invalid format

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/revisions/8d602198ec97/schema)