> ## Documentation Index
> Fetch the complete documentation index at: https://docs.signa.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Calendar Feed

> Get a calendar URL that Google Calendar, Outlook or Apple Calendar subscribes to

**Credits:** 0 per request.

Creates a secret iCalendar URL for your docket. Subscribe to it once and your
calendar app keeps it current on its own. Requires `portfolios:manage` and an
`Idempotency-Key` header. Free.

| Field | Required | Meaning |
| - | - | - |
| `name` | yes | The calendar's name in the calendar app. Up to 100 characters. |
| `portfolio_id` | no | Limit the feed to one portfolio. Omit it for the whole docket. 404 for a portfolio outside your organization. |

The response is the feed with `201 Created` and its `url`. **The URL is shown
once.** Signa stores only a hash of it, so it is not in
[List Calendar Feeds](https://docs.signa.so/api-reference/reference/list-calendar-feeds.md), and a
replay of the request with the same `Idempotency-Key` returns the feed without
it. Anyone with the URL can read the calendar: share it as you would a
password, and revoke it with
[Delete Calendar Feed](https://docs.signa.so/api-reference/reference/delete-calendar-feed.md) if it
leaks.

An organization can have 20 feeds. A 21st returns 409
`resource_quota_exceeded`; revoke one you no longer use.

```typescript theme={null}
const feed = await signa.calendarFeeds.create({
  name: 'Trademark deadlines',
  portfolio_id: 'ptf_019d2141-6ce9-771b-872e-bc8b20e49fcf',
});
console.log(feed.url); // https://api.signa.so/calendar/sgcal_….ics
```

What the calendar holds, and how to subscribe in each calendar app, is in
[Calendar Feeds](https://docs.signa.so/guides/calendar-feeds.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.