# Managing Connections

Whether you're creating a [customer connection](https://prismatic.io/docs/integrations/connections/integration-agnostic-connections/customer-activated.md), [organization (customer) connection](https://prismatic.io/docs/integrations/connections/integration-agnostic-connections/org-activated-customer.md), or [organization (global) connection](https://prismatic.io/docs/integrations/connections/integration-agnostic-connections/org-activated-global.md), you can manage your connections in one of two places:

1. From a component's connections page. Click **Components** on the left sidebar and then search for the component whose connections you want to manage. You can alter an existing connection or create a new one by clicking **+ Add Connection**.
2. From the low-code integration designer when you add new steps to your integration.

## Adding a new connection for a component[​](#adding-a-new-connection-for-a-component "Direct link to Adding a new connection for a component")

After clicking **Components** on the left sidebar, search for the component whose connections you want to manage and click on it. From that component's **Connections** tab, select **+ Add Connection** to create a new connection for that component.

You will be asked to select the connection type based on **whose credentials** the connection uses - your customer's, or your organization's?

![Whose credentials ](/docs/assets/images/whose-credentials-32d491adba925d47e25b005b50028cad.png)

If you select **Customer-Specific Credentials**, and the connection is not an OAuth 2.0 connection, you will next be asked who supplies those credentials. Your customer might supply them themselves (for example, by clicking an OAuth 2.0 button or pasting in their own API key), or you might supply them on the customer's behalf (for example, by generating an API key for your customer in your own app for seamless authentication).

![Who completes authentication ](/docs/assets/images/who-completes-auth-3cfce9fcb9ce31d2ceb38bb59a443e8d.png)

On the other hand, if you select **Your Organization's Credentials**, you're creating an [organization (global) connection](https://prismatic.io/docs/integrations/connections/integration-agnostic-connections/org-activated-global.md) that can be used across all of your customers. You'll be prompted for your organization's connection information.

Regardless of [connection type](https://prismatic.io/docs/integrations/connections.md#choosing-a-connection-type), you will be prompted to select the type of connection you want to create (if the component has multiple), and any global values you would like all of your customers to inherit. Typically, OAuth 2.0 connections contain mostly global values for authorize URL, client ID, scopes, etc., while API key connections contain mostly customer-specific values for the API key itself.

![Create connection ](/docs/assets/images/create-connection-8ba4aa4103df58f82aca805d467e22c7.png)

### Syncing connections between tenants[​](#syncing-connections-between-tenants "Direct link to Syncing connections between tenants")

If your organization has multiple tenants (for example, a US and EU tenant, or a dev and prod tenant), be sure to assign your connections the same **Stable Key** in each tenant. Then, when you [sync integrations](https://prismatic.io/docs/configure-prismatic/integrations-multiple-regions.md) between tenants, your integrations will automatically use the correct connections in the new tenant.

## Adding a new connection from the low-code integration designer[​](#adding-a-new-connection-from-the-low-code-integration-designer "Direct link to Adding a new connection from the low-code integration designer")

When you add a step to your integration that requires a connection, if one for that component already exists, you'll be prompted to select from existing connections.

![Select existing connection ](/docs/assets/images/use-existing-in-designer-6a20fae01b3f407f17152cb2e469293d.png)

If no connections already exist, you will be prompted to create a new connection of a type of your choosing, similar to adding a new connection on the component's **Connections** tab.

![Create new connection in designer ](/docs/assets/images/create-new-in-designer-17420d71656c41ac061193898c82294f.png)

If you would like to switch which connection you're using for a particular step, you can click the connection in the step editor and select a different connection, or create a new one.

![Switch connection in designer ](/docs/assets/images/switch-connection-in-designer-172dce847e5dc2503f05dc7e4e19dc44.png)

If you would like to switch **all steps** using the same connection to a different connection, open the config wizard designer (settings icon in the toolbar at the top of the designer) and edit your integration's connection to use a different one.

## Configuring a test connection for building integrations[​](#configuring-a-test-connection-for-building-integrations "Direct link to Configuring a test connection for building integrations")

After creating a new connection, you'll be prompted to supply test credentials for that connection. These test credentials will be used in the integration designer as you're building integrations that rely on the connection.

If you'd like to change your test credentials at any time, you can return to the **Connections** tab of a component, select your connection, and edit your credentials under **Test Runner Connection**. Your test instances that run as you test your integration in the integration designer will immediately begin using the new test credentials that you supply.

## Enabling a connection for the embedded workflow builder[​](#enabling-a-connection-for-the-embedded-workflow-builder "Direct link to Enabling a connection for the embedded workflow builder")

If you embed the [workflow builder](https://prismatic.io/docs/embed/workflow-builder.md) in your app for your customers to build their own workflows, you can choose which connections to expose to them. Open the connection you want to make available, and toggle on **Use for embedded workflows**.

![Use for embedded workflows ](/docs/assets/images/use-for-embedded-workflows-fb04b18b03682ce226ace3b755529bac.png)