---
title: "Create an iCal subscription"
method: POST
path: "/rest/api/v1/projects/{projectId}/calendarSubscriptions"
tags: ["News API"]
---

# Create an iCal subscription

`POST /rest/api/v1/projects/{projectId}/calendarSubscriptions`

The response carries the full feed URL including the token. It is shown once and only its hash is stored.

## Path parameters

- `projectId` string, uuid, required

## Request body

- CalendarSubscriptionDTO
  - `alias` string
  - `createdAt` string, date-time
  - `currencies` string[]
  - `customerEmail` string — Who created the subscription. A subscription belongs to the project, this is only the audit trail
  - `id` string
  - `includeHolidays` boolean
  - `lastUsedAt` string, date-time
  - `minImpact` 'HOLIDAY' | 'LOW' | 'MEDIUM' | 'HIGH'
  - `projectId` string, uuid
  - `requestCount` integer
  - `url` string — The feed URL including the token. Returned once, at creation, and never again

## Response `200`

OK

- CalendarSubscriptionDTO
  - `alias` string
  - `createdAt` string, date-time
  - `currencies` string[]
  - `customerEmail` string — Who created the subscription. A subscription belongs to the project, this is only the audit trail
  - `id` string
  - `includeHolidays` boolean
  - `lastUsedAt` string, date-time
  - `minImpact` 'HOLIDAY' | 'LOW' | 'MEDIUM' | 'HIGH'
  - `projectId` string, uuid
  - `requestCount` integer
  - `url` string — The feed URL including the token. Returned once, at creation, and never again

## Changes

- **2026-08-30** `69d2d39c695e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/metacopier/apis/metacopier-api/changes/rest/api/v1/projects/:projectId/calendarSubscriptions/post.md)

---

[API](https://skmtc.dev/metacopier/apis/metacopier-api.md) · [All operations](https://skmtc.dev/metacopier/apis/metacopier-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/metacopier/metacopier-api/revisions/69d2d39c695e/schema)