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

# List Connectors

`GET /connector/connectors`

List Connectors

## Query parameters

- `cursor` string, nullable
- `limit` integer
- `filter` ConnectorsFilter
  - `unified_api` 'accounting' | 'ats' | 'calendar' | 'crm' | 'csp' | 'customer-support' | 'ecommerce' | 'email' | 'email-marketing' | 'expense-management' | 'file-storage' | 'form' | 'hris' | 'lead' | 'payroll' | 'pos' | 'procurement' | 'project-management' | 'script' | 'sms' | 'spreadsheet' | 'subscription-analytics' | 'team-messaging' | 'issue-tracking' | 'time-registration' | 'transactional-email' | 'vault' | 'data-warehouse' — Name of Apideck Unified API
  - `status` 'live' | 'beta' | 'early-access' | 'development' | 'considering' — Status of the connector. Connectors with status live or beta are callable.

## Headers

- `x-apideck-app-id` string, required

## Response `200`

Connectors

- GetConnectorsResponse
  - `status_code` integer, required — HTTP Response Status Code
  - `status` string, required — HTTP Response Status
  - `data` Connector[], required
    - `id` string — ID of the connector.
    - `name` string — Name of the connector.
    - `status` 'live' | 'beta' | 'early-access' | 'development' | 'considering' — Status of the connector. Connectors with status live or beta are callable.
    - `description` string, nullable — A description of the object.
    - `icon_url` string, uri — Link to a small square icon for the connector.
    - `logo_url` string — Link to the full logo for the connector.
    - `website_url` string, uri — Link to the connector's website.
    - `signup_url` string, uri — Link to the connector's signup page.
    - `partner_signup_url` string, uri — Link to the connector's partner program signup page.
    - `free_trial_available` boolean — Set to `true` when the connector offers a free trial. Use `signup_url` to sign up for a free trial
    - `migration_targets` string[] — Service ids of connectors this connector's connections can be migrated to via the Vault connectionsMigrate operation.
    - `auth_type` 'oauth2' | 'apiKey' | 'basic' | 'custom' | 'none' — Type of authorization used by the connector
    - `auth_only` boolean — Indicates whether a connector only supports authentication. In this case the connector is not mapped to a Unified API, but can be used with the Proxy API
    - `blind_mapped` boolean — Set to `true` when connector was implemented from downstream docs only and without API access. This state indicates that integration will require Apideck support, and access to downstream API to validate mapping quality.
    - `oauth_grant_type` 'authorization_code' | 'client_credentials' | 'password' — OAuth grant type used by the connector. More info: https://oauth.net/2/grant-types
    - `oauth_credentials_source` 'integration' | 'connection' — Location of the OAuth client credentials. For most connectors the OAuth client credentials are stored on integration and managed by the application owner. For others they are stored on connection and managed by the consumer in Vault.
    - `oauth_scopes` object[] — List of OAuth Scopes available for this connector.
      - `id` string — ID of the OAuth scope.
      - `label` string — Label of the OAuth scope.
      - `default_apis` string[] — List of Unified APIs that request this OAuth Scope by default. Application owners can customize the requested scopes.
    - `custom_scopes` boolean — Set to `true` when connector allows the definition of custom scopes.
    - `has_sandbox_credentials` boolean — Indicates whether Apideck Sandbox OAuth credentials are available.
    - `settings` ConnectorSetting[]
      - `id` string
      - `label` string
      - `type` 'text' | 'checkbox' | 'tel' | 'email' | 'url' | 'textarea' | 'select' | 'filtered-select' | 'multi-select' | 'datetime' | 'date' | 'time' | 'number' | 'password'
    - `service_id` string — Service provider identifier
    - `unified_apis` object[] — List of Unified APIs that feature this connector.
      - `id` 'accounting' | 'ats' | 'calendar' | 'crm' | 'csp' | 'customer-support' | 'ecommerce' | 'email' | 'email-marketing' | 'expense-management' | 'file-storage' | 'form' | 'hris' | 'lead' | 'payroll' | 'pos' | 'procurement' | 'project-management' | 'script' | 'sms' | 'spreadsheet' | 'subscription-analytics' | 'team-messaging' | 'issue-tracking' | 'time-registration' | 'transactional-email' | 'vault' | 'data-warehouse' — Name of Apideck Unified API
      - `name` string — Name of the API.
      - `auth_only` boolean — Indicates whether a connector only supports authentication. In this case the connector is not mapped to a Unified API, but can be used with the Proxy API
      - `oauth_scopes` object[]
        - `id` string — ID of the OAuth scope.
        - `label` string — Label of the OAuth scope.
      - `supported_resources` LinkedConnectorResource[] — List of resources that are supported on the connector.
        - `id` string — ID of the resource, typically a lowercased version of name.
        - `name` string — Name of the resource (plural)
        - `status` 'live' | 'beta' | 'development' | 'upcoming' | 'considering' — Status of the resource. Resources with status live or beta are callable.
        - `downstream_id` string — ID of the resource in the Connector's API (downstream)
        - `downstream_name` string — Name of the resource in the Connector's API (downstream)
      - `downstream_unsupported_resources` ResourceId[] — List of resources that are not supported on the downstream.
      - `supported_events` ConnectorEvent[] — List of events that are supported on the connector for this Unified API.
        - `event_type` string — Unify event type
        - `event_source` 'native' | 'virtual' — Unify event source
        - `downstream_event_type` string — Downstream event type
        - `resources` ResourceId[]
        - `entity_type` string — Unify entity type
    - `supported_resources` LinkedConnectorResource[] — List of resources that are supported on the connector.
      - `id` string — ID of the resource, typically a lowercased version of name.
      - `name` string — Name of the resource (plural)
      - `status` 'live' | 'beta' | 'development' | 'upcoming' | 'considering' — Status of the resource. Resources with status live or beta are callable.
      - `downstream_id` string — ID of the resource in the Connector's API (downstream)
      - `downstream_name` string — Name of the resource in the Connector's API (downstream)
    - `configurable_resources` ResourceId[] — List of resources that have settings that can be configured.
    - `supported_events` ConnectorEvent[] — List of events that are supported on the connector across all Unified APIs.
      - `event_type` string — Unify event type
      - `event_source` 'native' | 'virtual' — Unify event source
      - `downstream_event_type` string — Downstream event type
      - `resources` ResourceId[]
      - `entity_type` string — Unify entity type
    - `webhook_support` WebhookSupport — How webhooks are supported for the connector. Sometimes the connector natively supports webhooks, other times Apideck virtualizes them based on polling.
      - `mode` 'native' | 'virtual' | 'none' — Mode of the webhook support.
      - `subscription_level` 'connection' | 'integration' — Received events are scoped to connection or across integration.
      - `managed_via` 'manual' | 'api' — How the subscription is managed in the downstream.
      - `virtual_webhooks` object — Virtual webhook config for the connector.
        - `request_rate` object, required — The rate at which requests for resources will be made to downstream.
          - `rate` integer, required — The number of requests per window unit.
          - `size` integer, required — Size of request window.
          - `unit` 'second' | 'minute' | 'hour' | 'day', required — The window unit for the rate.
        - `resources` object — The resources that will be requested from downstream.
    - `schema_support` SchemaSupport — When a connector has schema_support, a call can be made to retrieve a json schema that describes a downstream resource.
      - `supported` boolean — Can a resource schema be retrieved for this connector?
    - `docs` ConnectorDoc[]
      - `id` string — A unique identifier for an object.
      - `name` string — Name of the doc.
      - `audience` 'application_owner' | 'consumer' — Audience for the doc.
      - `format` 'markdown' — Format of the doc.
      - `url` string, uri — Link to fetch the content of the doc.
    - `overview` ConnectorOverview — Editorial overview metadata for the connector, used to render the connector's Overview documentation (implementation difficulty, partnership requirements, sandbox availability, and other at-a-glance facts).
      - `beta` boolean — Whether this connector's overview content is still in beta.
      - `demo` boolean — Whether this connector is demo-only.
      - `difficulty` 'straightforward' | 'moderate' | 'involved' | 'highly_complex', required — At-a-glance implementation difficulty rating.
      - `difficulty_reason` string, required — Short explanation of why the connector has the given difficulty rating.
      - `authentication_note` string — Notes on the connector's authentication flow.
      - `webhooks` string — Description of webhook support for this connector.
      - `partnership_required` boolean, required — Whether a partnership with the downstream provider is required.
      - `partnership_url` string, uri — URL to the downstream provider's partnership/developer portal.
      - `partnership_note` string — Additional notes about the partnership requirement.
      - `partnership_portal_name` string — Name of the downstream provider's developer portal.
      - `apideck_credentials_available` boolean, required — Whether Apideck-managed credentials are available for this connector.
      - `apideck_credentials_note` string — Additional notes about Apideck-managed credentials.
      - `costs` string — Notes on costs associated with using this connector.
      - `rate_limits` string — Notes on rate limits enforced by the downstream provider.
      - `account_type_required` string, required — The type of downstream account required to use this connector.
      - `sandbox_available` boolean, required — Whether a sandbox environment is available for this connector.
      - `sandbox_url` string, uri — URL to the downstream provider's sandbox environment.
      - `sandbox_note` string — Additional notes about the sandbox environment.
      - `consumer_access_level` string, required — The access level a consumer's end user needs to authorize the connection.
      - `important_to_know` string[] — Flat list of important facts about this connector.
      - `supported_resource_categories` object[] — Grouping of the connector's supported resources by category.
        - `name` string, required — Category name.
        - `resources` string[], required — Resource ids belonging to this category.
      - `external_guides` object[] — Links to external guides relevant to this connector.
        - `title` string, required — Guide title.
        - `url` string, uri, required — Guide URL.
        - `source` string, required — Publisher of the guide.
      - `responsibility_matrix` object[] — Who is responsible for each area of the integration. Cell values are display strings (e.g. "✓", "Docs provided"), not booleans.
        - `area` string, required — The responsibility area.
        - `apideck` string — Apideck's responsibility for this area.
        - `consumer` string — The consumer's responsibility for this area.
        - `customer` string — The end customer's responsibility for this area.
      - `environment_notes` object[] — Notes about the different environments (sandbox, production, etc.) available for this connector.
        - `environment` string, required — Environment name.
        - `description` string, required — Description of the environment.
    - `tls_support` object
      - `type` string
      - `description` string — Description of the TLS support
  - `_raw` Raw, nullable — Raw response from the integration when raw=true query param is provided
  - `meta` Meta — Response metadata
    - `items_on_page` integer — Number of items returned in the data property of the response
    - `cursors` object — Cursors to navigate to previous or next pages through the API
      - `previous` string, nullable — Cursor to navigate to the previous page of results through the API
      - `current` string, nullable — Cursor to navigate to the current page of results through the API
      - `next` string, nullable — Cursor to navigate to the next page of results through the API
    - `total_count` integer — Number of records available in total for this resource
    - `warnings` object[], nullable — Non-fatal warnings emitted when optional workflow steps failed. Present only when at least one step degraded; the response status remains 200.
      - `type` string — Discriminator for the warning kind.
      - `status_code` integer, nullable — HTTP status code returned by the failed downstream request, when available.
      - `error` string, nullable — Short error description from the downstream provider, when available.
      - `operation` string, nullable — Identifier of the workflow step that failed.
      - `message` string, nullable — Detailed message from the downstream provider, when available.
  - `links` Links — Links to navigate to previous or next pages through the API
    - `previous` string, nullable — Link to navigate to the previous page through the API
    - `current` string — Link to navigate to the current page through the API
    - `next` string, nullable — Link to navigate to the previous page through the API

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required
- `default` — Unexpected error

## Changes

- **2026-08-06** `fc25d22431a0` — 1 info
  - added the optional property `data/items/migration_targets` to the response with the `200` status
- **2026-07-23** `2c08c8a926f3` — 1 info
  - added the optional property `data/items/overview` to the response with the `200` status
- **2026-06-19** `4fa24035e087` — 1 info
  - added the optional property `meta/warnings` to the response with the `200` status
- **2026-06-15** `1cd29f012f6d` — 1 info
  - added the optional property `meta/total_count` to the response with the `200` status
- **2026-05-21** `6438d7207761` — 1 warning, 1 info
  - added the new `subscription-analytics` enum value to the `data/items/unified_apis/items/id` response property for the response status `200`
  - added the enum value `subscription-analytics` to the property `unified_api` of the `query` request parameter `filter`

[Full history](https://skmtc.dev/apideck-libraries/apis/connector-api/changes/connector/connectors/get.md)

---

[API](https://skmtc.dev/apideck-libraries/apis/connector-api.md) · [All operations](https://skmtc.dev/apideck-libraries/apis/connector-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apideck-libraries/connector-api/revisions/4ccda2709e55/schema)