---
title: "Get Connector"
method: GET
path: "/connector/connectors/{id}"
tags: ["Connectors"]
---

# Get Connector

`GET /connector/connectors/{id}`

Get Connector

## Path parameters

- `id` string, required

## Headers

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

## Response `200`

Connectors

- GetConnectorResponse
  - `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
    - `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.
    - `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
  - `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

- `401` — Unauthorized
- `402` — Payment Required
- `404` — The specified resource was not found
- `default` — Unexpected error

## Changes

- **2026-05-21** `6438d7207761` — 1 warning
  - added the new `subscription-analytics` enum value to the `data/unified_apis/items/id` response property for the response status `200`
- **2026-03-31** `b460c649137b` — 2 warning, 1 info
  - removed the optional property `meta/total_count` from the response with the `200` status
  - removed the optional property `meta/warnings` from the response with the `200` status
  - removed the `subscription-analytics` enum value from the `data/unified_apis/items/id` response property for the response status `200`

[Change history](https://skmtc.dev/apideck-libraries/apis/connector-api/changes/connector/connectors/:id/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.dev/apideck-libraries/apis/connector-api/revisions/f96df01a0d55?raw)