---
title: "Get the inbox's calendar subscription URL"
method: GET
path: "/v1/inboxes/{inbox_id}/calendar/feed"
tags: ["Calendar"]
---

# Get the inbox's calendar subscription URL

`GET /v1/inboxes/{inbox_id}/calendar/feed`

## Request

- Base URL: `https://api.deadsimple.email`
- URL: `https://api.deadsimple.email/v1/inboxes/{inbox_id}/calendar/feed`
- Auth: HTTP bearer

Returns the .ics feed URL (https and webcal) for this inbox, creating its feed token on first request. The same URL comes back on every call until it is rotated. Hand it to a human to add the agent's calendar to Google Calendar, Apple Calendar or Outlook. The token is the only credential on the feed, so treat the URL as a secret. SDK: `calendar.feed`.

## Path parameters

- `inbox_id` string, required

## Response `200`

Feed URLs.

- CalendarFeed
  - `inbox_id` string
  - `email` string
  - `feed_url` string: https URL of the .ics feed, token included. Paste into Google Calendar ("From URL"), Apple Calendar or Outlook.
  - `webcal_url` string: The same feed as a webcal:// link, which most calendar apps open as a subscription.
  - `token_created_at` string
  - `rotated` boolean: True when this call issued a new token (the first request, or a rotate).

---

[API](https://skmtc.dev/deadsimple/apis/dead-simple-email-api.md) · [All operations](https://skmtc.dev/deadsimple/apis/dead-simple-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/deadsimple/apis/dead-simple-email-api/revisions/c697881be131?raw)