Add to Shopify

Settings → Integrations (Fulfil)

Connect your Fulfil account so setlist can sync raw-material stock and costs. Your API token is stored encrypted and never exposed to the browser.

Where: setlist → Settings → Integrations Powers: the Materials catalog and the read-only bills of materials on matching products

What it does

Fulfil stays the source of truth for supplies. Connecting it lets setlist import your full material catalog — every product that appears as a BOM input in Fulfil — with stock-on-hand and unit costs into the Materials catalog, and pull each matching product SKU's bill of materials into setlist read-only. Large catalogs sync in bounded chunks automatically.

The integration is read-only. setlist reads from Fulfil and never writes to it. Synced BOM lines are marked as coming from Fulfil and can't be edited or removed in setlist — the app answers "This BOM is synced from Fulfil and is read-only in setlist." Each sync rewrites them: a variant whose SKU has an active Fulfil BOM takes that BOM as its complete supply list, while a variant Fulfil has no BOM for keeps its hand-added lines and just loses any stale synced ones. Pushing BOMs from setlist to Fulfil is disabled — setlist refuses before contacting Fulfil at all.

Connect

  1. Go to Settings → Integrations.
  2. Enter your Fulfil subdomain — the part before .fulfil.io in your Fulfil URL (e.g. acme).
  3. Paste your Personal Access Token (Fulfil API token).
  4. Click Connect Fulfil. setlist tests the connection first; on success you'll see "Fulfil connected."

Once connected, the section shows a Connected badge plus your Subdomain, Last sync ("Never" until the first run), and Status, with Sync now and Disconnect buttons.

Set it up

  1. Connect Fulfil (above).
  2. Click Sync now to pull materials into the Materials catalog.
  3. Re-sync any time stock or costs change.

Sync runs from either page — Sync now here, or Sync from Fulfil on Materials. Both do the same work.

Good to know

  • The token is stored encrypted server-side — it's never sent to the browser.
  • Disconnect removes the stored connection (your materials catalog stays until you change it).
  • Rate limits are handled for you. If Fulfil throttles a read, setlist retries it up to five times with a growing wait (honoring Fulfil's own Retry-After), so a busy Fulfil account slows a sync down rather than failing it.
  • Archived and deleted BOM components don't break a sync. setlist re-fetches archived records deliberately; if a component was deleted outright, that one BOM is skipped and reported in the sync result instead of failing the run.
  • If a sync is interrupted, starting it again is safe — setlist may ask you to "Start the sync again" rather than resuming a half-finished run.

See also