---
title: "Send Test Calendar Invite"
method: POST
path: "/developer/calendar-invites/send"
tags: ["Developer", "Developer - Calendar"]
---

# Send Test Calendar Invite

`POST /developer/calendar-invites/send`

## Request

- Base URL: `https://api.openintake.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openintake.ai/developer/calendar-invites/send`
- Auth: none declared

Send a test calendar invite to a staff member's calendar.

This endpoint is restricted to developer users only.
Creates a calendar event using the same logic as the meeting booking system,
but does NOT create a Meeting record in the database.

Use this to test calendar invite formatting without polluting the database.

If meeting_id is provided, uses the meeting's data and associated lead info.
Otherwise, falls back to legacy manual fields.

## Request body

- SendCalendarInviteRequest: Request to send a test calendar invite
  - `meeting_id` string, uuid, nullable: Meeting ID to use for calendar invite (preferred)
  - `start_time_override` string, nullable: Override start time in ISO format (for testing multiple invites)
  - `duration_minutes_override` integer, nullable: Override duration in minutes (for testing)
  - `recipient_user_id_override` string, uuid, nullable: Override recipient user (send to different user's calendar for testing)
  - `staff_user_id` string, uuid, nullable: The staff user whose calendar will receive the invite
  - `first_name` string, nullable: Attendee first name
  - `last_name` string, nullable: Attendee last name
  - `phone_number` string, nullable: Attendee phone number
  - `email` string, nullable: Attendee email (optional)
  - `case_id` string, uuid, nullable: Case ID (optional)
  - `start_time` string, nullable: Event start time in ISO format
  - `duration_minutes` integer, nullable: Event duration in minutes

## Response `200`

Successful Response

- SendCalendarInviteResponse: Response from sending a test calendar invite
  - `success` boolean, required: Whether the invite was sent successfully
  - `event_id` string, nullable: Calendar event ID if successful
  - `event_title` string, nullable: Event title that was created
  - `calendar_provider` string, nullable: Calendar provider used
  - `message` string, required: Status message

## Other responses

- `422`: Validation Error

---

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