---
title: "Link a connector"
method: POST
path: "/v2/{env_id}/{flow_id}/{tenant}/linkedConnectors"
---

# Link a connector

`POST /v2/{env_id}/{flow_id}/{tenant}/linkedConnectors`

Create a new connection for your tenant, along with an optional schedule and field map, without using the embedded widget.

## Path parameters

- `env_id` string, required
- `flow_id` string, required
- `tenant` string, required

## Request body

- object
  - `connector` object, required — Connector
    - `id` string, required — The ID of your connector. You can fetch this from your available or supported connectors
    - `config` object — The config object holds key-value pairs with credentials and flags for your connector. These are shared for imports and exports.
    - `symlink` object — Symlink allows you to share credentials with a connection from another flow or subtenant
      - `id` string — The previously linked flow_id containing a user's credentials
      - `tenant` string — Optional. If using subtenants, the tenant id that has the linked connector in the same flow.
      - `type` 'target' — Optional. If symlinking from a target flow, pass `target`. Can be left empty for source flows or bidirectional flows.
  - `schedule` object — The schedule expression to sync on
    - `schedule_expression` string — CRON expression to set or update the schedule
    - `state` '"ENABLED"' | '"DISABLED'
  - `field_map` object — The field map to use (if not provided, will use default)

## Response `200`

200

- object

## Other responses

- `400` — 400

---

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