Meetings

Create a meeting

Creates a new meeting. The authenticated user is automatically added as a participant and organizer.

post/api/meetings

Request

  • Base URL: https://api.wondercal.com
  • URL: https://api.wondercal.com/api/meetings
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional idempotency key (max 255 chars). When provided, retrying the same request within 24 hours with the same key and identical body returns the cached response instead of re-executing. Do not embed sensitive data in the key value — keys may appear in server logs on certain error paths. Use a distinct key per endpoint call — the key is scoped to your user account only, not to the endpoint URL, so reusing the same key across different endpoint calls may return an incorrect cached response.

Request body

titlestring required

Meeting title

durationinteger required

Duration in minutes (5 to 480)

descriptionstring nullable

Optional description

locationstring nullable

Optional — where the meeting will happen (a conferencing link, room name, or address)

Example request

{
  "title": "Weekly Standup",
  "duration": 30,
  "description": "Team sync meeting"
}

Response

Meeting created successfully

Example response

{
  "data": {
    "id": "m5gmdr9txcq6dqaasj5q9p0d5h7753xh",
    "title": "Weekly Standup",
    "duration": 30,
    "description": "Team sync meeting",
    "location": "https://meet.google.com/abc-def-ghi",
    "status": "pending",
    "createdAt": "2026-01-15T10:30:00.000Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.