---
title: "Updates calendar data according to provider API."
method: POST
path: "/integrations/calendar/{integration_id}/calendars/update"
tags: ["calendar"]
---

# Updates calendar data according to provider API.

`POST /integrations/calendar/{integration_id}/calendars/update`

## Request

- Base URL: `https://localhost:8080/api/v9`
- URL: `https://localhost:8080/api/v9/integrations/calendar/{integration_id}/calendars/update`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/toggl/apis/toggl-api/docs/integrations/calendar/:integration_id/calendars/update/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint uses the passed integration to get a provider and update all the calendars from that

## Path parameters

- `integration_id` integer, required

## Response `200`

Calendars successfully retrieved

- HandlercalendarFetchedCalendarsResponse
  - `fetched_calendars` integer

## Other responses

- `400`: Possible error messages: * invalid integration\_id value * error fetching data from the provider
- `401`: Possible error messages: * calendar access has been expired or revoked * user account may have been deleted at the provider
- `402`: outlook calendar integration is a starter feature
- `403`: you do not have access to the integration
- `404`: Possible error messages: * invalid calendar provider * calendar integration does not exist
- `500`: Internal Server Error

---

[API](https://skmtc.dev/toggl/apis/toggl-api.md) - [All operations](https://skmtc.dev/toggl/apis/toggl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/toggl/apis/toggl-api/revisions/3085aee16990?raw)