> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hotglue.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connectors

> What are Connectors?

# What is a Connector?

Each third party integration that your users can interact with is called a **Connector**. Connectors are grouped together within flows.

For example, an e-commerce flow may include many different **Connectors**, such as Shopify, Amazon Seller, and WooCommerce.

## Connectors vs Sources vs Targets

Connectors can contain **taps**, an integration to read data, and **targets**, an integration to write data.

In [V1 jobs](/api-reference/v1/introduction), Connectors are managed separately depending on whether they read or write data:

* **Sources** are Connectors that only read data
* **Targets** are Connectors that only write data

## What is an available Connector?

An **available Connector** is a Connector that you can add to your hotglue flows. You can find a complete list of the [default available Connectors here](https://hotglue.com/connectors).
You can also [fork and create custom Connectors](/cli/env) via the Hotglue CLI.

## What is a supported Connector?

A **supported Connector** is a Connector that you have configured to be available within a flow.

## What is a linked Connector?

A **linked Connector** is a instance of Connector that has been successfully connected to by a particular tenant.

# Connector Configuration

There are four main configuration options for Hotglue Connectors:

1. Credentials
2. Field maps
3. ETL scripts
4. Triggers

## Credentials

Connectors generally use one of two types of authorization: APIs and OAuth. Before enabling an OAuth Connector, you must obtain and set up OAuth credentials.

1. Your **Client ID** and **Client Secret** will be found in your company or developer account for that Connector.
2. Scope is used for some OAuth applications to define the data you will be reading or writing. This will prompt tenants to confirm the data permissions you are requesting.

![](https://files.readme.io/3b50c42-Hotglue-Oauth-API-Credentials.png)

## Field maps (V2 Connectors and V1 Sources only)

Field maps allow you to choose what data hotglue will pull in a sync job.

**The field map** displays a list of **tables** that can be turned on or off. Within each table, **the field editor** displays a list of **fields** that can be pulled or ignored.

To modify a field map for a Connector, navigate to your chosen flow, click the "Connectors" (or "Sources" on V1 jobs) tab, then select a Connector to configure it.

![](https://files.readme.io/26fbbb6-Screen_Shot_2022-11-30_at_12.28.07_PM.png)

Under configuration, click “customize field map.” From here, you can toggle **tables** on or off by clicking them.

![](https://files.readme.io/6998ef5-Screen_Shot_2022-11-30_at_12.27.32_PM.png)

Click the “edit” pencil button on a given table to add or remove fields.

## ETL script

[ETL scripts](https://docs.hotglue.com/docs/transformations-overview) (or transformation scripts) can be used to transform raw data from your Connector into a digestible format for your backend or Targets.

## Triggers

Triggers create webhooks on your behalf to automatically run jobs when something happens in a Connector system.

For example, when a new contact is added in Salesforce, a trigger can automatically run a new sync job.
