---
title: "Get URL for setting up a calendar integration with given provider."
method: GET
path: "/integrations/calendar/setup"
tags: ["calendar"]
---

# Get URL for setting up a calendar integration with given provider.

`GET /integrations/calendar/setup`

## Request

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

Set up an integration with a given provider, returning a URL to the said provider in order to

## Query parameters

- `provider` string, required
- `return_to` string

## Other responses

- `302`: URL to authenticate with the provider
- `400`: invalid provider name
- `402`: user plan does not allow multiple integrations with the same provider
- `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)