---
title: "Get connector"
method: GET
path: "/api/connectors/{host}"
---

# Get connector

`GET /api/connectors/{host}`

## Request

- Base URL: `https://reduck.ai`
- URL: `https://reduck.ai/api/connectors/{host}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Fetch the connector for a host, cookies included, ready for a run to inject. A host with no connector of its own is served by its nearest parent's, and a host with neither is a 404. When the site holds several connectors for the profile, name one with `account` or `label` (an empty `label` for the one without a label).

## Path parameters

- `host` string, required

## Query parameters

- `profile` string: The end-user this connector is kept for, in your own naming (for example your user id). Omit, or leave empty, for your own account's connectors. Only an API key or an OAuth token can read or create an end-user's connector.
- `account` string: The connector whose account (as its probe or SSO sign-in reported it) is this one.
- `label` string: The connector with this label, or "" for the one without a label.

## Response `200`

OK

- ConnectorWithCookies
  - `cookies` ConnectorCookie[], required
    - `name` string, required
    - `value` string, required
    - `domain` string, required
    - `path` string, required
    - `expires` number, required: Unix seconds.
    - `httpOnly` boolean, required
    - `secure` boolean, required
    - `sameSite` 'Strict' | 'Lax' | 'None'
  - `id` string, required
  - `host` string, required: The website, bare: no scheme, no leading "www.", e.g. "linkedin.com". For an SSO connector this is the identity provider, e.g. "accounts.google.com".
  - `profile_id` string, required: The end-user this connector is kept for, as the developer named them. Empty for the account's own connectors.
  - `account` string, nullable, required: The identity a probe script or the SSO sign-in reported (usually an email). Null until one has; it is never set by hand.
  - `label` string, nullable, required: The name a person gave this connector, to tell it apart from the host's others.
  - `is_sso` boolean, required: True when this is an identity-provider session usable for "Continue with <provider>".
  - `sso_account` string, nullable, required: For a connector created through an SSO connector: that SSO's account (email). The reference autoreconnect follows. Null otherwise.
  - `created_at` string, required
  - `updated_at` string, required

## Other responses

- `401`: Not authenticated
- `403`: An end-user's connector is read with an API key or an OAuth token, not from a browser session.
- `404`: Not found
- `409`: Several connectors match; the body's `connectors` lists them. Name one with `account` or `label`.

---

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