POST/v1/meetingsmeetings:write

Schedule a meeting

Creates a calendar event on the API key owner's Google Calendar. Adds a Google Meet link by default. Auto-spawns a 30-minute prep task. Returns immediately with `status: "scheduling"`; the outbox handler stamps `scheduled` once the calendar insert completes.

Run a request

POST/v1/meetings

Base URL

Request body (JSON)

Resolved URL

POSThttps://coldos.justgotwyrd.com/api/v1/meetings

Paste an API key in the bar at the top of the page to enable Execute.

Parameters

Body parameters

contact_iduuidrequired
Contact the meeting is with.
titlestringrequired
Calendar event title.
starts_atiso8601required
Start time (any timezone).
ends_atiso8601required
End time.
descriptionstringoptional
Calendar event description.
add_meet_linkbooleanoptionaldefault true
Attach a Google Meet link.
attendee_user_idsuuid[]optional
Cold OS user ids to add as attendees (resolved to emails).

Responses

400Invalid request — see `error.message`.
401Missing or invalid API key.
403Authenticated, but the key lacks the required scope.
404The referenced resource does not exist or is not visible to your key.
429Rate limit exceeded — see `Retry-After`.
500Unexpected server error. Safe to retry with idempotency-key.

Code samples

curl -X POST "https://coldos.justgotwyrd.com/api/v1/meetings" \
  -H "Authorization: Bearer $COLD_OS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "contact_id": "c2a8a93a-2f1c-4c5b-8f3d-9c1e3a8b5d12",
      "title": "Cold OS x Acme — pipeline walkthrough",
      "starts_at": "2026-05-04T16:00:00.000+05:30",
      "ends_at": "2026-05-04T16:30:00.000+05:30",
      "add_meet_link": true
    }'

Response · 200

{
  "id": "01HZS6X0Y9Z8W7V6U5T4S3R2Q1",
  "contact_id": "c2a8a93a-2f1c-4c5b-8f3d-9c1e3a8b5d12",
  "organizer_id": "b1f2c3d4-5678-90ab-cdef-1234567890ab",
  "title": "Cold OS x Acme — pipeline walkthrough",
  "description": "30-min pipeline walkthrough; bring the Q2 dashboard.",
  "status": "scheduling",
  "outcome": null,
  "starts_at": "2026-05-04T16:00:00.000+05:30",
  "ends_at": "2026-05-04T16:30:00.000+05:30",
  "meeting_url": null,
  "google_calendar_event_id": "abcdefghijklmnop1234567890",
  "attendees": [
    "ankit@example.com",
    "polymath@justgotwyrd.com"
  ]
}

Was this page helpful?

Your vote stays in this browser. We'll use it to prioritise rewrites.