Skip to content
Back to Docs

Connections

Authenticate and manage connections to your data sources and destinations.

Overview

Connections represent authenticated links to external services. Each connection is reusable across multiple pipelines and scoped to your current workspace (personal account or organization). You can create connections to data sources (where data comes from) and destinations (where data goes).

To manage connections, go to Connections in the sidebar. From there you can add, test, edit, or delete connections.

Connection Types

Shopify

OAuth 2.0

Setup

  1. Click Add Connection and select Shopify.
  2. Enter your store domain (e.g. my-store.myshopify.com).
  3. Authorize via the Shopify OAuth flow — SnowPipe requests read access to products, orders, and inventory.
  4. The connection is saved and ready to use in pipelines.

Capabilities

  • Products with variant expansion
  • Inventory levels per location
  • Metafields
  • Orders and customers

Note: For large catalogs (10K+ products), SnowPipe automatically uses Shopify GraphQL Bulk Operations for efficient, constant-memory syncing.

WooCommerce

Consumer Key + Secret

Setup

  1. In WooCommerce, go to Settings → Advanced → REST API and create a key with Read access.
  2. Copy the Consumer Key and Consumer Secret.
  3. In SnowPipe, click Add Connection, select WooCommerce, and paste your store URL and credentials.
  4. Click Test Connection to verify.

Capabilities

  • Products with variations
  • Inventory tracking
  • Orders and customers

Note: Your WooCommerce store must use HTTPS. HTTP-only stores are not supported for security reasons.

Google Merchant Center

Google OAuth

Setup

  1. Click Add Connection and select Google Merchant Center.
  2. Sign in with your Google account and authorize SnowPipe.
  3. Enter your Merchant ID, target country, and language.
  4. Click Test Connection to verify access.

Capabilities

  • Product feed upload
  • CSV and NDJSON export formats

Note: Used as a destination. SnowPipe uploads your mapped product data directly to your Merchant Center account.

Facebook Commerce

System User Token

Setup

  1. Create a System User in Meta Business Manager (business.facebook.com > Business Settings > System Users).
  2. Assign your product catalog to the System User with Full Control.
  3. Generate an access token with catalog_management permission.
  4. In SnowPipe, click Add Connection, select Facebook Commerce, and paste your token and Catalog ID.
  5. Click Test Connection to verify.

Capabilities

  • Product catalog sync (batch upload up to 5,000 items/request)
  • Variant grouping via item_group_id
  • Inventory quantity sync

Note: System User tokens are long-lived and won't expire when someone changes their Facebook password. Facebook recommends this over personal OAuth tokens for API stability.

Square

Access Token

Setup

  1. In the Square Developer Dashboard, create an application and generate an access token.
  2. In SnowPipe, click Add Connection and select Square.
  3. Paste your access token and enter your Location ID.
  4. Choose Sandbox or Production environment.

Capabilities

  • Catalog sync (items, categories, variations)
  • Inventory counts per location

Note: Use Sandbox mode for testing before switching to Production.

FTP / FTPS

Username + Password

Setup

  1. Click Add Connection and select FTP.
  2. Enter the host, port (default 21), username, and password.
  3. Specify the remote directory path for file delivery.
  4. Toggle FTPS if your server requires encrypted connections.

Capabilities

  • Automated CSV/NDJSON file delivery
  • Configurable remote path
  • FTPS encryption support

Note: Files are uploaded to the specified remote path each time a pipeline runs.

Amazon S3

AWS Access Key + Secret

Setup

  1. Create an IAM user with S3 read/write permissions for your target bucket.
  2. In SnowPipe, click Add Connection and select S3.
  3. Enter the Access Key ID, Secret Access Key, bucket name, and AWS region.
  4. Optionally specify a key prefix path.

Capabilities

  • Direct S3 file upload
  • Configurable bucket and prefix
  • Multiple AWS regions

Note: The IAM user only needs s3:PutObject and s3:GetObject on the target bucket.

Local File (CSV)

None

Setup

  1. Click Add Connection and select Local File.
  2. Configure the filename, delimiter (comma, tab, pipe), and whether the file has a header row.
  3. Use this connection as a source by uploading a CSV, or as a destination for file downloads.

Capabilities

  • CSV upload and download
  • Configurable delimiter
  • Header row detection

Note: Ideal for one-time imports or exporting data for manual review.

Managing Connections

Test Connection

After creating a connection, click Test to verify credentials and connectivity. The test performs a lightweight API call or connection handshake to confirm everything works.

Status Indicators

Each connection shows a status: Connected (last test passed), Untested (never tested), or Error (last test failed).

Deleting Connections

You can delete a connection that is no longer in use. Connections that are referenced by active pipelines cannot be deleted — remove them from those pipelines first.

Need help?

Reach out at support@snowforge.dev