---
title: "Update calendar"
method: PUT
path: "/v1/calendars/{id}"
tags: ["Calendars"]
---

# Update calendar

`PUT /v1/calendars/{id}`

## Request

- Base URL: `https://api.forwardemail.net`
- URL: `https://api.forwardemail.net/v1/calendars/{id}`
- Auth: HTTP basic

Update an existing calendar. You can update any of the calendar properties including name, description, color, timezone, and order. If you change the name to one that already exists, a conflict error will be returned.

## Path parameters

- `id` string, required

## Request body

- CalendarUpdateInput
  - `name` string: Calendar name
  - `description` string: Calendar description
  - `color` string: Calendar color (hex format)
  - `timezone` string: Calendar timezone
  - `order` integer: Calendar display order

## Response `200`

Calendar updated successfully

- Calendar
  - `id` string, required: Calendar ID (calendarId from CalDAV)
  - `name` string, required: Calendar name
  - `description` string, required: Calendar description
  - `color` string, required: Calendar color (hex format)
  - `timezone` string, required: Calendar timezone
  - `order` integer, required: Calendar display order
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `object` 'calendar', required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `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)