---
title: "List connectors"
method: GET
path: "/connectors"
tags: ["Connectors"]
---

# List connectors

`GET /connectors`

## Request

- Base URL: `https://app.italic.com/api/v2`
- URL: `https://app.italic.com/api/v2/connectors`
- Auth: HTTP bearer

Required permission: workflows:read or connectors:manage. Connected apps and accounts, and each app's permission. Connecting an account is a sign-in with the provider, in the Italic apps.

## Response `200`

Success. Writes without read permission return an ID and revision only.

- ConnectorList
  - `connectors` Connector[], required
    - `id` string, required
    - `name` string, required
    - `accounts` object[], required
      - `id` string, required
      - `label` string, required
      - `email` string
      - `status` string
  - `permissions` Permission[], required
    - `tool` 'send_email' | 'create_event' | 'create_reminder' | 'create_notion_page' | 'send_slack_message' | 'save_to_drive', required
    - `label` string, required
    - `mode` 'ask' | 'allow' | 'off', required
    - `accounts` object, required: Accounts with their own permission, by account ID.

## Other responses

- `default`: Request failed. Errors include a stable code and a readable message.

---

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