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

# Get connectors

`GET /api/connectors`

Get all connectors in the current tenant.

## Query parameters

- `target` string

## Response `200`

An array of connectors.

- object[]
  - `id` string, required
  - `syncProfile` boolean, required
  - `enableTokenStorage` boolean, required
  - `config` object, required — arbitrary
  - `metadata` object, required
    - `target` string
    - `name` object — Validator function
    - `logo` string
    - `logoDark` string, nullable
  - `connectorId` string, required
  - `target` string, required
  - `name` object, required — Validator function
  - `description` object, required — Validator function
  - `logo` string, required
  - `logoDark` string, nullable, required
  - `readme` string, required
  - `configTemplate` string
  - `formItems` union[]
    - union
      - object
        - `type` string, "Select", required
        - `selectItems` object[], required
          - `value` string, required
          - `title` string, required
        - `key` string, required
        - `label` string, required
        - `placeholder` string
        - `required` boolean
        - `defaultValue` unknown
        - `showConditions` object[]
          - `targetKey` string, required
          - `expectValue` unknown
        - `description` string
        - `tooltip` string
        - `isConfidential` boolean
        - `isDevFeature` boolean
      - object
        - `type` string, "MultiSelect", required
        - `selectItems` object[], required
          - `value` string, required
        - `key` string, required
        - `label` string, required
        - `placeholder` string
        - `required` boolean
        - `defaultValue` unknown
        - `showConditions` object[]
          - `targetKey` string, required
          - `expectValue` unknown
        - `description` string
        - `tooltip` string
        - `isConfidential` boolean
        - `isDevFeature` boolean
      - object
        - `type` 'Text' | 'Number' | 'MultilineText' | 'Switch' | 'Json', required
        - `key` string, required
        - `label` string, required
        - `placeholder` string
        - `required` boolean
        - `defaultValue` unknown
        - `showConditions` object[]
          - `targetKey` string, required
          - `expectValue` unknown
        - `description` string
        - `tooltip` string
        - `isConfidential` boolean
        - `isDevFeature` boolean
  - `customData` object
  - `fromEmail` string
  - `platform` 'Native' | 'Universal' | 'Web', nullable, required
  - `isStandard` boolean
  - `isTokenStorageSupported` boolean
  - `type` 'Email' | 'Sms' | 'Social', required
  - `isDemo` boolean
  - `extraInfo` object
  - `usage` number

## Other responses

- `400` — The target only allows one connector to exist, but there are multiple connectors with this target.
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/logto/apis/logto-api-references.md) · [All operations](https://skmtc.net/logto/apis/logto-api-references/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/logto/logto-api-references/revisions/a163dc77d842/schema)
