Skip to main content

Connect a store & sync orders

A bridge is a live connection to a platform you already run on, such as Shopify, ShipStation, WooCommerce, BigCommerce, Amazon, or your own API. Once a bridge is connected, Orderly pulls orders in and pushes fulfillment out, so everything lives in one place.

Open Bridges

Connect a bridge​

Go to Bridges and click Add Bridge. Pick the platform you want to connect. They are grouped by category (E-Commerce, Shipping & Fulfillment, Marketplaces, ERP, Marketing), and a ⚡ icon on a tile means that platform supports real-time webhooks.

What you enter next depends on how the platform authenticates.

Shopify (and other OAuth platforms)​

Shopify connects over OAuth, so you do not need an API key or access token.

  1. Give the connection a Display Name, for example "Main Store".
  2. Under Store Connection, type your store's subdomain in Shop Domain. That is the mystore part of mystore.myshopify.com.
  3. Click Connect with Shopify. You are redirected to Shopify to authorize, then returned to Orderly.

Orderly registers the order webhooks as soon as the connection completes, so real-time order sync is on without further steps. Open ⋯ → Configure to see the webhook status or re-register them (covered below). If webhooks are unavailable, Orderly falls back to scheduled polling.

BigCommerce follows the same OAuth pattern.

Amazon Seller​

Amazon connects through Seller Central's app authorization, so there are no keys to copy.

  1. Pick your Region (North America, Europe, or Far East) and your Primary marketplace. One connection covers every marketplace in that region; connect a second region as a separate bridge.
  2. Leave Import FBA orders off unless you want orders Amazon fulfills to appear as read-only orders. By default Orderly imports only the orders you ship yourself.
  3. Click Connect with Amazon. You are sent to Seller Central to approve Orderly, then returned to Orderly with the bridge active.

You can also start from the Amazon Selling Partner Appstore: choose Orderly there, click Authorize, sign in to Orderly, and pick the organization to connect.

Once connected, schedule grab-orders (every 15 to 30 minutes is typical; Amazon rate-limits order searches, so faster is not useful) and push-open-fulfillments so tracking flows back as shipment confirmations. Orders arrive with the Amazon order id as the order number, the buyer's anonymized Amazon relay address as the email, and the recipient address from the order. Amazon's policies forbid using relay addresses for marketing.

Disconnecting removes Orderly's stored authorization. To revoke on Amazon's side as well, remove Orderly under Seller Central → Apps and Services → Manage your apps.

API-key platforms (ShipStation, WooCommerce)​

Platforms that use API credentials show an API Credentials section instead of the OAuth redirect. Fill in the fields the platform requires and click Connect. Orderly tests the credentials as part of connecting.

PlatformFields
ShipStationAPI Key, API Secret
WooCommerceSite URL, Consumer Key, Consumer Secret

Credentials are encrypted at rest. If a platform tile links to setup docs, use View setup documentation to find where each value lives in that platform's admin.

Custom API​

Choose Custom API when your application creates orders with the Orderly API or SDK. The bridge can be source-only, so its outbound URL is optional. To route orders to your own service, configure a public HTTPS URL and a signing secret, then enable order.dispatched under Outbound Events. See the Custom API bridge guide for the payload and signature.

Klaviyo has its own page

Selecting Klaviyo opens a dedicated connect page (Bridges → Klaviyo) where you authorize over OAuth and choose which events to forward. They arrive in Klaviyo as the branded metrics Orderly: Placed Order, Orderly: Order Shipped, and Orderly: Order Delivered, so they never collide with the metrics your store platform already sends. Use these to trigger your email and SMS flows.

When you connect, Orderly creates one sample event per metric against a profile named "Orderly Sample Customer" (klaviyo-sample@orderlycore.com) so you can build and test flows before your first live order. Every sample carries an orderly_sample: true property; exclude it from segments if you prefer.

Composio bridges (Slack)​

Some bridges, such as Slack, connect through Composio instead of a direct Orderly OAuth app. Click Connect on the Slack tile and you are redirected to Slack to authorize access, then returned to Orderly once the connection is active. Orderly never stores your Slack credentials: Composio holds the connection on Orderly's behalf, and Orderly only keeps a reference to it.

Once connected, configure three settings on the Slack bridge:

  • Slack channel: the channel that receives Orderly notifications, picked from a live list of your workspace's channels.
  • Claim lifecycle updates: post a message when a claim changes status.
  • Shipment exception alerts: post a message when a shipment records a delivery exception.

Disconnecting the bridge revokes Orderly's access in Slack; reconnect the same way at any time.

What each bridge card shows​

Back on the Bridges page, every connection is a card with its status (active, paused, error, disconnected, or authorization needed), the last sync time (or Never synced), and any error message. From a card you can:

  • Sync now pulls immediately. Available only when the bridge is active.
  • Tasks opens the bridge's tasks and schedules (see below).
  • ⋯ → Configure edits the name, rotates credentials, or manages webhooks.
  • ⋯ → Pause / Resume stops or restarts syncing without deleting the bridge.
  • ⋯ → Remove disconnects the bridge. This cannot be undone.

Run and schedule sync tasks​

Each bridge exposes a set of tasks, the concrete things it can do, like grab-orders, push-fulfillment, or grab-shipments. Open a bridge's Tasks & Schedules page (from the card, or ⋯ → Tasks & Schedules) to work with them. It has three tabs:

  • Tasks lists every task the bridge supports. Hover a row and click ▶ to run it once. If a task takes parameters, such as a date range for a backfill, a Run Task dialog collects them first. Otherwise it runs immediately.
  • Schedules holds recurring runs. From the Tasks tab, click the 📅 button on a schedulable task to set a cadence. Run every offers presets from Every 5 minutes through Weekly on Monday, including Daily at 6 AM and Weekdays at 9 AM. Pause, resume, or delete a schedule from its ⋯ menu.
  • History shows the last runs with their status (pending, queued, running, success, failed, retrying) and any error. Use it to confirm a sync worked, or to see why one did not.

Scheduling grab-orders to run every 15 to 30 minutes is the usual way to keep a store in sync when webhooks are not available.

Use a bridge with Fulfillment Operations​

Fulfillment Operations reads normalized signals from active fulfillment connections, so ShipStation, a WMS, and future 3PL bridges can participate in one operational workflow. A compatible bridge can report events such as label creation, warehouse departure, carrier acceptance, shipment exceptions, and delivery. It can also declare which actions it can prepare for review.

ShipStation can be selected during Fulfillment Operations setup. For another WMS or 3PL connection, confirm with Orderly that the bridge exposes operational capabilities before relying on it for cutoff monitoring.

Connecting a bridge does not turn on automatic operational changes. The current Fulfillment Operations workflow prepares recommendations for human approval and leaves execution in the system that owns the action.

See Set up Fulfillment Operations.

Turn on real-time webhooks​

Webhooks push new and updated orders the moment they happen, so you do not wait for the next scheduled poll. Open ⋯ → Configure on a bridge card. If the platform supports webhooks, a Real-time Webhooks section lists the available topics. Flip the switch on the ones you want.

Webhooks need HTTPS

Webhook destinations must be publicly reachable over HTTPS. Localhost and private network addresses cannot receive platform deliveries.

Next steps​