Adding a New Connection

Step-by-step guide to adding a new connection to your workspace.

Overview

A connection is your workspace's configured instance of a connector. Where a connector (like Shopify or MongoDB) is a global template describing what a service is, a connection holds your specific credentials, service URL, and any per-instance settings. Workflows reference connections, not connectors directly - so you create connections before you build workflows that talk to those services.

You can have multiple connections to the same connector (useful for multi-store or multi-region setups), and each connection lives inside a single workspace.

Before You Start

The credentials or API key for the service you want to connect.
For OAuth connections: an admin user who can authorize the integration on the service side.
For self-hosted services: the public URL of the service and any required authentication scheme.

Steps

Go to Connections from the sidebar.
Click + Add Connection.
Browse the catalog or search for the connector you want. Connectors are grouped by category (E-commerce, Databases, Communication, etc.).
Click the connector to start setup. Spojit shows the authentication method the connector requires.
Follow the authentication steps - the exact flow depends on the connector type (see below).
Give your connection a descriptive name. Names are visible to everyone in the workspace, so use something specific like Shopify - AU Store rather than just Shopify.
Click Save. Spojit runs a verification call against the service to confirm the credentials work, then marks the connection as Active.

Authentication Types

Different connectors require different authentication methods. Spojit handles the flow for each one:

OAuth - You'll be redirected to the service to authorize access. After authorizing, Spojit stores the access and refresh tokens and automatically refreshes them before they expire so the connection stays alive.
API Key - Enter your API key or token from the service. Spojit stores it encrypted at rest and never shows it in the UI again after saving. See Setting Up an API Key Connection for details.
Basic Auth - Enter a username and password.
Webhook - Spojit generates a unique webhook URL you paste into the service. See Setting Up a Webhook Connection.
No Auth - Some utility connectors (date, JSON, regex, etc.) don't need credentials.

Connection Settings

After saving, you can edit a connection to change:

Name - The display name shown in the workflow designer.
Visibility - All connections are workspace-wide and available to any member who has permission to build workflows. Credentials themselves are never exposed after saving - members can reference the connection in a workflow but cannot read or export the underlying key or token.
Credentials - Rotate keys without rebuilding workflows. Workflows reference the connection by ID, not by the underlying credential.
Service URL - For self-hosted instances (e.g. self-hosted MongoDB or your store's REST endpoint).

Tips

Name connections to disambiguate environment and instance: Shopify - Production AU, Stripe - Test, MySQL - Reporting Replica.
Create a separate connection for staging vs production so you don't accidentally hit live systems during testing.
Rotate credentials by editing the connection in place. Workflows continue working without modification because they reference the connection ID, not the credential itself.

Common Pitfalls

Insufficient scopes - OAuth integrations only request the minimum scopes Spojit needs. If you later need more (e.g. writing to a Shopify resource you only had read access for), you'll need to re-authorize the connection.
Token expiry on API key connections - Unlike OAuth, API keys do not refresh automatically. If the service rotates keys (or you do), update the connection.
Region or environment mismatch - The service URL field matters. A NetSuite sandbox URL on a production connection will silently hit the wrong account.
Connection name typos - Workflows that reference a connection by name won't find it if you rename later. Prefer to edit credentials in place rather than create a new connection.

Learn More

Connections documentation