Getting Started

The 3-Minute Quickstart

Welcome to EcomFlux. Let's get your first orders syncing — from workspace setup through Shopify and your courier.

Step 1: Create your workspace

Your workspace is the home for all channels, orders, and team members (your tenant in EcomFlux).

  1. Open the EcomFlux app and choose Sign up (or start from the marketing site Start Free Trial flow).
  2. Use a company email you control — you'll use it for billing alerts and security notifications.
  3. When prompted, enter your workspace / organization name. This is shown to your team and on exports; pick something your finance and ops teams will recognize.
  4. Complete email verification if required, then sign in. You should land on the dashboard with an empty inbox — that's expected until a channel is connected.

Tip:Only workspace owners can connect billing and certain integrations. If you're inviting teammates later, add them from workspace settings so everyone shares the same order inbox.

Step 2: Connect Shopify

EcomFlux ingests orders via the Shopify Admin API. You'll create a custom app in Shopify and paste credentials into EcomFlux (your product may also offer a one-click OAuth flow — use that if shown in the UI).

In Shopify Admin

  1. Go to Settings → Apps and sales channels.
  2. Click Develop apps (you may need to enable custom app development once per store).
  3. Click Create an app, name it (e.g. “EcomFlux sync”), and open the new app.
  4. Under Configuration → Admin API integration, click Configure and enable at minimum:
    • read_orders — so EcomFlux can import orders and line items.
    • write_inventory — so stock adjustments from fulfilled or cancelled orders can flow back to Shopify when you enable inventory sync.
  5. Install the app to the store, then open API credentials.
  6. Copy the Admin API access token (and note your store's API key / API secret key if your EcomFlux screen asks for them separately).

In EcomFlux

  1. Open Integrations (or Channels) and choose Shopify.
  2. Enter your store domain (e.g. your-store.myshopify.com) and paste the API key / token from Shopify as directed by the form.
  3. Save and run the initial sync. Within a few minutes you should see recent orders in the unified inbox.

Treat API tokens like passwords. Rotate them if exposed, and use separate dev/staging apps if you test against a non-production store.

Step 3: Connect your courier

Label generation and rate shopping in EcomFlux are typically powered by a shipping aggregator such as EasyPost or Shippo. You'll link your account so EcomFlux can purchase labels on your behalf.

  1. In your EasyPost or Shippo dashboard, create an API key with permissions appropriate for production shipping (often a production or live key — not a test key).
  2. In EcomFlux, open Settings → shipping or integrations (wording may vary) and find Courier / shipping provider.
  3. Paste the API token into the field for your provider and save.
  4. From an order, try Generate label (or your fulfillment flow) to confirm rates return and a label can be purchased.

If your stack uses a direct carrier contract instead of EasyPost/Shippo, follow the in-product carrier connection for that integration — the same principle applies: secure API credentials, production keys only, and verify with a test shipment when possible.

What's next?

  • Explore Automations to route orders by weight, country, or SKU.
  • Connect Accountingwhen you're ready for invoicing and exports.
  • Invite your team so fulfillment and support share one operational inbox.

Questions? Use Help inside the app or contact us from the website — we ship docs updates as features land.