# openemail.calendars

Calendars: create, read, update and delete them, their trash, their changes feed, import and export, sharing, feed tokens, and the invitations that arrive by…

Calendars: create, read, update and delete them, their trash, their changes feed, import and export, sharing, feed tokens, and the invitations that arrive by email.

Its 20 methods, each a page of its own, in the order the API reference presents them:

| Method | What it does | It calls |
| --- | --- | --- |
| [`calendars.create`](/docs/sdks/typescript/calendars/create) | Create calendar | [`POST /identities/{identityId}/calendars`](/docs/api/pim/post_CalendarCreate) |
| [`calendars.list`](/docs/sdks/typescript/calendars/list) | List calendars | [`GET /identities/{identityId}/calendars`](/docs/api/pim/get_CalendarList) |
| [`calendars.get`](/docs/sdks/typescript/calendars/get) | Get calendar by ID | [`GET /identities/{identityId}/calendars/{calendarId}`](/docs/api/pim/get_CalendarGet) |
| [`calendars.getByName`](/docs/sdks/typescript/calendars/get-by-name) | Get calendar by name | [`GET /identities/{identityId}/calendars/by-name/{name}`](/docs/api/pim/get_CalendarGetByName) |
| [`calendars.update`](/docs/sdks/typescript/calendars/update) | Update calendar | [`PATCH /identities/{identityId}/calendars/{calendarId}`](/docs/api/pim/patch_CalendarUpdate) |
| [`calendars.delete`](/docs/sdks/typescript/calendars/delete) | Delete calendar | [`DELETE /identities/{identityId}/calendars/{calendarId}`](/docs/api/pim/delete_CalendarDelete) |
| [`calendars.listTrash`](/docs/sdks/typescript/calendars/list-trash) | List deleted calendars | [`GET /identities/{identityId}/calendars/trash`](/docs/api/pim/get_CalendarTrashList) |
| [`calendars.restore`](/docs/sdks/typescript/calendars/restore) | Restore deleted calendar | [`POST /identities/{identityId}/calendars/trash/{trashedCalendarId}/restore`](/docs/api/pim/post_CalendarTrashRestore) |
| [`calendars.purge`](/docs/sdks/typescript/calendars/purge) | Purge deleted calendar | [`DELETE /identities/{identityId}/calendars/trash/{trashedCalendarId}`](/docs/api/pim/delete_CalendarTrashPurge) |
| [`calendars.getChanges`](/docs/sdks/typescript/calendars/get-changes) | Sync changes for calendar | [`GET /identities/{identityId}/calendars/{calendarId}/changes`](/docs/api/pim/get_CalendarChanges) |
| [`calendars.import`](/docs/sdks/typescript/calendars/import) | Import calendar data | [`POST /identities/{identityId}/calendars/{calendarId}/import`](/docs/api/pim/post_CalendarImport) |
| [`calendars.export`](/docs/sdks/typescript/calendars/export) | Export whole calendar | [`GET /identities/{identityId}/calendars/{calendarId}/export`](/docs/api/pim/get_CalendarExport) |
| [`calendars.grantAccess`](/docs/sdks/typescript/calendars/grant-access) | Grant calendar access | [`PUT /identities/{identityId}/calendars/{calendarId}/shares/{shareeIdentityId}`](/docs/api/pim/put_CalendarSharePut) |
| [`calendars.revokeAccess`](/docs/sdks/typescript/calendars/revoke-access) | Revoke calendar access | [`DELETE /identities/{identityId}/calendars/{calendarId}/shares/{shareeIdentityId}`](/docs/api/pim/delete_CalendarShareDelete) |
| [`calendars.listAccess`](/docs/sdks/typescript/calendars/list-access) | List calendar access grants | [`GET /identities/{identityId}/calendars/{calendarId}/shares`](/docs/api/pim/get_CalendarShareList) |
| [`calendars.createFeedToken`](/docs/sdks/typescript/calendars/create-feed-token) | Create calendar feed token | [`POST /identities/{identityId}/calendars/{calendarId}/tokens`](/docs/api/pim/post_CalendarTokenCreate) |
| [`calendars.listFeedTokens`](/docs/sdks/typescript/calendars/list-feed-tokens) | List calendar feed tokens | [`GET /identities/{identityId}/calendars/{calendarId}/tokens`](/docs/api/pim/get_CalendarTokenList) |
| [`calendars.revokeFeedToken`](/docs/sdks/typescript/calendars/revoke-feed-token) | Revoke calendar feed token | [`DELETE /identities/{identityId}/calendars/{calendarId}/tokens/{tokenId}`](/docs/api/pim/delete_CalendarTokenRevoke) |
| [`calendars.getInvitationStatus`](/docs/sdks/typescript/calendars/get-invitation-status) | Check invitation status by UID | [`GET /identities/{identityId}/calendars/invitations`](/docs/api/pim/get_PimInvitationStatusRoute) |
| [`calendars.respondToInvitation`](/docs/sdks/typescript/calendars/respond-to-invitation) | Accept or decline emailed invitation | [`POST /identities/{identityId}/calendars/invitations/respond`](/docs/api/pim/post_PimInvitationRespond) |

In the API reference: [PIM](/docs/api/pim).
