---
title: "Create calendar event"
method: POST
path: "/v1/calendar-events"
tags: ["Calendar Events"]
---

# Create calendar event

`POST /v1/calendar-events`

## Request

- Base URL: `https://api.forwardemail.net`
- URL: `https://api.forwardemail.net/v1/calendar-events`
- Auth: HTTP basic

Create a new calendar event with iCalendar data. The event will be validated and parsed to extract common properties for easy access.

## Request body

- CalendarEventInput
  - `calendar_id` string, required: ID of the calendar to add the event to
  - `event_id` string: Custom event ID (if not provided, will be auto-generated)
  - `ical` string, required: iCalendar (RFC 5545) data for the event. Must be valid iCal format.

## Response `200`

Calendar event created successfully

- CalendarEvent
  - `id` string, required: Calendar event ID (eventId from CalDAV)
  - `calendar_id` string, required: ID of the calendar this event belongs to
  - `ical` string, required: iCalendar (RFC 5545) data for the event
  - `summary` string: Event title/summary (extracted from iCal data)
  - `description` string: Event description (extracted from iCal data)
  - `location` string: Event location (extracted from iCal data)
  - `start_date` string, date-time: Event start date/time (extracted from iCal data)
  - `end_date` string, date-time: Event end date/time (extracted from iCal data)
  - `uid` string: Unique identifier from iCal data
  - `status` string: Event status (extracted from iCal data)
  - `organizer` string: Event organizer (extracted from iCal data)
  - `deleted_at` string, date-time, nullable: Soft deletion timestamp
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `object` 'calendar_event', required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `409`: Conflict
- `500`: Internal Server Error

---

[API](https://skmtc.dev/forwardemail/apis/forward-email-api.md) · [All operations](https://skmtc.dev/forwardemail/apis/forward-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/forwardemail/apis/forward-email-api/revisions/ecefab4527f6?raw)