---
title: "Link a source"
method: POST
path: "/{env_id}/{flow_id}/{tenant}/linkedSources"
---

# Link a source

`POST /{env_id}/{flow_id}/{tenant}/linkedSources`

Create a new connection for a tenant by passing a config object, along with an optional schedule or field_map

## Path parameters

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

## Request body

- object
  - `source` object, required — The source & settings info you wish to link
    - `tap` string, required — Name of tap
    - `config` object — JSON object containing settings for the source
    - `symlink` object — Symlink allows you to share credentials with a connection from another flow
      - `entity` string — The name of the connector that is already linked
      - `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.
  - `schedule` object — The schedule expression to sync on
    - `schedule_expression` string — A CRON expression defining how often to run jobs for the tenant
    - `state` 'ENABLED' | 'DISABLED' — Whether the schedule should be enabled or disabled
  - `field_map` object, nullable — The field map to use (if not provided, will use default)

## Response `200`

200

- object

## Other responses

- `400` — 400

---

[API](https://skmtc.net/hotglue/apis/hotglue-api.md) · [All operations](https://skmtc.net/hotglue/apis/hotglue-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hotglue/hotglue-api/versions/30ff54d01ec0/schema)