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

# Managing Connections

> Connect external services to Spojit so your workflows can interact with them.

A **connection** is a configured instance of a connector that stores your credentials and service-specific settings. You need a connection before you can use an integration connector (like Shopify, Slack, or Resend) in a workflow.

<Tip>
  Built-in utility connectors (Text, JSON, Math, etc.) don't require a connection; they work immediately.
</Tip>

## Adding a connection

<Steps>
  <Step title="Open the Connections page">
    Navigate to **Connections** in the sidebar. You'll see a list of available connectors and any connections you've already configured.
  </Step>

  <Step title="Choose a connector">
    Find the connector you want (e.g., Shopify) and click **Add Connection**.
  </Step>

  <Step title="Enter credentials">
    Fill in the required fields; these vary by connector. For example, Shopify requires a store name and Admin API access token.
  </Step>

  <Step title="Save">
    Click **Save**. Spojit validates your credentials and the connection appears in your list.
  </Step>
</Steps>

## Connection types

Different connectors use different authentication methods:

| Type           | Description                          | Example         |
| -------------- | ------------------------------------ | --------------- |
| **API Key**    | A secret key provided by the service | Shopify, Resend |
| **Token**      | A bot or access token                | Slack           |
| **OAuth**      | Browser-based authorization flow     | GitHub          |
| **Basic Auth** | Username and password                | HTTP connector  |

## Multiple connections

You can create multiple connections to the same connector. This is useful when you work with more than one account, for example two Shopify stores or separate Slack workspaces.

Each connection is identified by its name, so give them descriptive labels like "Production Store" and "Staging Store".

## Editing a connection

Click on an existing connection to update its credentials or settings. Changes take effect immediately for any workflow that uses the connection.

## Removing a connection

<Warning>
  Removing a connection breaks any workflow that depends on it. Make sure no active workflows reference the connection before removing it.
</Warning>

To remove a connection, open it and click **Remove Connection**. This deletes the stored credentials from Spojit.

## Connection security

* Credentials are encrypted and stored securely.
* Secrets are never exposed in the UI after saving.
* Each connection is scoped to your workspace; other workspaces cannot access it.
