---
title: "Schedule a meeting for a conversation"
method: POST
path: "/ocs/v2.php/apps/spreed/api/{apiVersion}/room/{token}/meeting"
tags: ["room"]
---

# Schedule a meeting for a conversation

`POST /ocs/v2.php/apps/spreed/api/{apiVersion}/room/{token}/meeting`

Required capability: `schedule-meeting`

## Path parameters

- `apiVersion` 'v4', required
- `token` string, required

## Headers

- `OCS-APIRequest` boolean, required

## Request body

- object
  - `calendarUri` string, required — Last part of the calendar URI as seen by the participant e.g. 'personal' or 'company_shared_by_other_user'
  - `start` integer, required — Unix timestamp when the meeting starts
  - `attendeeIds` integer[], nullable — List of attendee ids to invite, if null everyone will be invited, if empty array only the actor will receive the event
  - `end` integer, nullable — Unix timestamp when the meeting ends, falls back to 60 minutes after start
  - `title` string, nullable — Title or summary of the event, falling back to the conversation name if none is given
  - `description` string, nullable — Description of the event, falling back to the conversation description if none is given

## Response `200`

Meeting scheduled

- object
  - `ocs` object, required
    - `meta` OCSMeta, required
      - `status` string, required
      - `statuscode` integer, required
      - `message` string
      - `totalitems` string
      - `itemsperpage` string
    - `data` unknown, required

## Other responses

- `400` — Meeting could not be created successfully
- `401` — Current user is not logged in

---

[API](https://skmtc.dev/nextcloud/apis/spreed-full.md) · [All operations](https://skmtc.dev/nextcloud/apis/spreed-full/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nextcloud/spreed-full/revisions/41d6458d6d6e/schema)