---
title: "create a meeting request"
method: POST
path: "/meeting/tasks"
tags: ["meeting"]
---

# create a meeting request

`POST /meeting/tasks`

## Request

- Base URL: `https://api.calendarhero.com`
- URL: `https://api.calendarhero.com/meeting/tasks`
- Auth: API key in header `Authorization`

## Request body

- Model16
  - `locations` Model14[]
    - `name` string
  - `capacity` number: The number of seats required for a meeting room. If zero, then no meeting room will be booked.
  - `contacts` Model15[]
    - `id` string, required: The contact's ID as returned from GET /contact
  - `contactEmails` string[]
  - `subject` string, required: The meeting topic/subject
  - `type` string: The meeting type. Must be one of the user's defined meeting types returned from GET /user/meeting
  - `dateStart` string, date, required: The requested timeframe's start date/time (YYYY-MM-DDTHH:mm:ssZ). The date component (YYYY-MM-DD) represents the start of the availability range while the time component (HH:mm:ssZ) represents the start time for each day of the availability range.
  - `dateEnd` string, date, required: The requested timeframe's ending date/time (YYYY-MM-DDTHH:mm:ssZ). The date component (YYYY-MM-DD) represents the end of the availability range while the time component (HH:mm:ssZ) represents the end time for each day of the availability range.
  - `meetingLength` number: The number of minutes of the requested meeting. If omited, the meeting type's meeting duration will be used.
  - `location` string
  - `room` Room
    - `capacity` number: The number of seats required for a meeting room. If zero, then no meeting room will be booked.
  - `roomCapacity` number
  - `description` string: The agenda/description of the meeting

## Response `default`

Successful

- string

---

[API](https://skmtc.dev/calendarhero/apis/calendarhero-api.md) · [All operations](https://skmtc.dev/calendarhero/apis/calendarhero-api/llms.txt) · [OpenAPI document](https://skmtc.dev/calendarhero/apis/calendarhero-api/revisions/687e58e57a8d?raw)