Create meeting

curl -X POST "https://your-collabase.ch/api/v1/meetings" \
  -H "Authorization: Bearer clb_xYz123ABCD..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Release planning",
    "date": "2026-10-15",
    "time": "10:00",
    "durationMinutes": 45,
    "spaceId": "cm1space001"
  }'

{ "data": { "id": "cm2meet0001abcd" } }

{ "error": { "code": "VALIDATION_ERROR", "message": "The project does not belong to this space" } }

{ "error": { "code": "FORBIDDEN", "message": "Not allowed to create meetings in this space" } }

{ "error": { "code": "VALIDATION_ERROR", "message": "Video link must be an http(s) URL" } }

POST

api

meetings

curl -X POST "https://your-collabase.ch/api/v1/meetings" \
  -H "Authorization: Bearer clb_xYz123ABCD..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Release planning",
    "date": "2026-10-15",
    "time": "10:00",
    "durationMinutes": 45,
    "spaceId": "cm1space001"
  }'

{ "data": { "id": "cm2meet0001abcd" } }

{ "error": { "code": "VALIDATION_ERROR", "message": "The project does not belong to this space" } }

{ "error": { "code": "FORBIDDEN", "message": "Not allowed to create meetings in this space" } }

{ "error": { "code": "VALIDATION_ERROR", "message": "Video link must be an http(s) URL" } }

Creates a draft with the token owner as organizer. A draft appears only in its organizers’ calendar view and sends nothing. Plan the meeting to send the invitations.

Scope meetings:write. To create a meeting in a Space, the token owner needs to see that Space; in a project, they also need access to the project.

Request body

string

required

Up to 200 characters.

string

required

YYYY-MM-DD in the token owner’s time zone.

string

required

HH:mm in the token owner’s time zone.

number

required

Whole minutes, 1 to 720.

string | null

Space the meeting belongs to.

string | null

Project within that Space. Requires spaceId.

string | null

Up to 500 characters.

string | null

An http or https link, up to 2,000 characters.

string

default:"STANDARD"

STANDARD or PRIVATE. A private meeting is visible to its participants only.

boolean

default:"false"

Participants may edit the agenda and record outcomes, not only organizers.

number

default:"0"

Share of the duration kept free when planning the agenda, 0 to 50.

boolean

default:"false"

Submitted topics go straight onto the agenda instead of waiting for review.

number | null

default:"null"

Topics are taken until this many hours before the start (1 to 336); null means until it starts.

Response

object

required

Show properties

string

required

The new meeting.

curl -X POST "https://your-collabase.ch/api/v1/meetings" \
  -H "Authorization: Bearer clb_xYz123ABCD..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Release planning",
    "date": "2026-10-15",
    "time": "10:00",
    "durationMinutes": 45,
    "spaceId": "cm1space001"
  }'

{ "data": { "id": "cm2meet0001abcd" } }

{ "error": { "code": "VALIDATION_ERROR", "message": "The project does not belong to this space" } }

{ "error": { "code": "FORBIDDEN", "message": "Not allowed to create meetings in this space" } }

{ "error": { "code": "VALIDATION_ERROR", "message": "Video link must be an http(s) URL" } }

Last modified on October 4, 2026

Overview

Pages

Work Items

Meetings

Test Management

Automation

SCIM 2.0

Health

Request body

Response

​Request body

​Response

Request body

Response