Pipelines
A pipeline listens for a specific Shopify webhook event and forwards it to a destination URL. You can optionally reshape the payload, add authentication, and control delivery rate.
Pipelines List
The Pipelines page shows all configured pipelines in a table:
| Column | Description |
|---|---|
| Pipeline Name | Your chosen name |
| Shopify Topic | The webhook event type (e.g. products/update) |
| Status | Active (green) or Disabled (grey) |
| Traffic (24H) | Sparkline of requests over the past 24 hours |
| Errors (24H) | Sparkline of delivery failures over the past 24 hours |
Click Edit on any row to open the pipeline editor.
The Add Pipeline button appears when your plan allows more pipelines. If you have reached your plan's limit, an Upgrade Plan button is shown instead.
Creating or Editing a Pipeline
The pipeline editor is divided into four sections.
1. Route Configuration
| Field | Description |
|---|---|
| Pipeline Enabled | Toggle off to pause delivery without deleting the pipeline |
| Pipeline Name | A human-readable label shown in the list and in failure reports |
| Shopify Webhook Event Trigger | The event that activates this pipeline (e.g. orders/create) |
| Destination URL | The HTTPS endpoint ShopVector should forward the payload to |
Changing the event type reloads the available source fields for payload mapping.
2. Payload Reshaping
Enable Remap Fields to transform the Shopify payload before it is delivered. When enabled, a visual node editor appears.
Working with the canvas
- Add Input Node — select a Shopify source property from the dropdown and click the button to add it as a node on the left side of the canvas.
- Add Output Node — enter the destination field path (e.g.
items[].id) and click the button to add it as a node on the right side. - Connect nodes — drag from a source node to a destination node to map one field to the other.
- Rename or delete a node — right-click any node to open a context menu.
- Auto Arrange Canvas — click this button to tidy the layout automatically.
- You can pan the canvas by dragging the background and zoom with the scroll wheel.
If remapping is disabled, the full original Shopify payload is forwarded unchanged.
3. Authentication & Signing
These options control how ShopVector authenticates outbound requests to your destination.
HMAC Signing
Available on all plans. When enabled, ShopVector adds a signature header to every request so your endpoint can verify the payload has not been tampered with.
| Field | Description |
|---|---|
| Header Name | The HTTP header ShopVector will add (e.g. X-Signature) |
| Secret Key | The shared secret used to compute the signature |
| Digest Algorithm | Base64 or HEX encoding for the signature value |
OAuth 2.0
Available on plans that include OAuth2. When enabled, ShopVector fetches a bearer token before each delivery.
| Field | Description |
|---|---|
| Client ID | Your OAuth2 client identifier |
| Client Secret | Your OAuth2 client secret |
| Token Endpoint URL | The URL ShopVector calls to obtain a token |
| Scopes | Comma-separated scopes, each in quotes (e.g. "read", "write") |
4. Delivery Constraints
Rate Limiting
Available on plans that include rate limiting. Enable Rate Limiting and set a Max Requests per Second to prevent ShopVector from overwhelming your destination.
Custom HTTP Headers
Add arbitrary headers to every forwarded request. Click Add to insert a new key/value row, and the delete icon to remove one. Useful for API keys or routing tokens your destination requires.
Saving and Deleting
- Save — persists all changes. The pipeline becomes active immediately if it is enabled.
- Cancel — discards changes and returns to the pipelines list.
- Delete Pipeline — permanently removes the pipeline. A confirmation dialog is shown before deletion. This action cannot be undone.