---
title: "Create one or more user-owned recurring event series atomically"
method: POST
path: "/day-plan/event-series"
tags: ["day-plan"]
---

# Create one or more user-owned recurring event series atomically

`POST /day-plan/event-series`

## Request

- Base URL: `https://api.focusbear.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.focusbear.io/day-plan/event-series`
- Auth: HTTP bearer

## Request body

- CreateEventSeriesDto
  - `events` CreateEventSeriesItemDto[], required
    - `title` string, required
    - `description` string
    - `dtstart_local` string, required: Local DTSTART without an offset. RFC 5545 timezone rules apply when this time is ambiguous or falls in a DST gap.
    - `dtend_local` string, required: Local DTEND without an offset. Its difference from DTSTART is stored as a wall-clock duration of at most 24 hours, independent of timezone-offset changes. If a generated end falls in a DST gap, event_ends is normalized to a real instant.
    - `timezone` string, required: IANA timezone used to interpret DTSTART, DTEND, and recurrences
    - `rrule` string, required: One unfolded RFC 5545 RRULE content line. Supports DAILY, plain-weekday WEEKLY, constrained MONTHLY, and non-leap-day YEARLY rules. COUNT and UTC UNTIL are optional but cannot be combined.

## Response `201`

- CreateEventSeriesResponseDto
  - `series` EventSeriesResponseDto[], required
    - `dtend_local` string, required: Nominal local end derived from DTSTART and wall-clock duration; it can name a nonexistent wall time during a DST gap
    - `rrule` string, required: Canonical unfolded RFC 5545 RRULE content line
    - `id` string, required
    - `title` string, required
    - `description` string, nullable, required
    - `dtstart_local` string, required
    - `timezone` string, required
    - `created_at` string, required
    - `updated_at` string, required

---

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