# Add a calendar to an assistant

`POST https://www.getrevox.com/api/assistants/{id}/calendars`

Add a calendar on a provider, before any account is connected to it. Connect it next, or create an invite link for a colleague to connect their own: connecting gives it the handle the prompt mentions, named after the account (`google_calendar_aric_at_getrevox.com`).

## Path parameters

- `id` (string, required)

## Request body (JSON)

- `provider` (enum (string), required): One of: `google-calendar`, `calendly`, `cal-com-oauth`.

## Example request

```bash
curl -X POST https://www.getrevox.com/api/assistants/3c90c3cc-0d44-4b50-8888-8dd25736052a/calendars \
  -H "Authorization: Bearer $REVOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "cartesia"
  }'
```

## Responses

### 200: Success

- `calendar` ([AssistantCalendar](https://www.getrevox.com/docs/api/objects/assistant-calendar.md), required)

### 400: Invalid request: the body or a parameter failed validation

- `message` (string, optional)
- `error` (string, optional)
- `bodyErrors` (object, optional): The validation errors returned from the API.
  - `issues` (array of object, required)
    - `path` (array of one of, required)
      - One of, **string** (string)
      - One of, **number** (number)
    - `message` (string, required)
    - `code` (string, optional)

### 404: Not found in your organization

- `message` (string, optional)
- `error` (string, optional)
- `bodyErrors` (object, optional): The validation errors returned from the API.
  - `issues` (array of object, required)
    - `path` (array of one of, required)
      - One of, **string** (string)
      - One of, **number** (number)
    - `message` (string, required)
    - `code` (string, optional)