---
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`

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/fastapi.md) · [All operations](https://skmtc.dev/openintake/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintake/fastapi/revisions/b642b91e0a5c/schema)