Connect BigCommerce to Foundry

A BigCommerce store with admin access

You'll be creating a Store-level API account in BC, which requires admin permission. If you're not the owner, ask whoever runs the store to either give you admin or generate the credentials and hand them off.

A Foundry account at app.foundryims.com

If you don't have one yet, sign up free. OWNER or ADMIN role is needed to create channels.

Open the API account dialog

In BigCommerce admin, go to Settings → API → Store-level API accounts → Create API account. Pick V2/V3 API token as the type and name it "Foundry IMS" (or whatever's easy to recognize later).

Grant these OAuth scopes

Foundry needs the scopes below — read/write for the resources it manages, read-only for the ones it just observes:

• • Products — modify
• • Orders — modify
• • Order Transactions — read-only
• • Customers — read-only
• • Information & Settings — read-only
• • Sites & Routes — read-only (needed to register webhooks)

Click Save. BigCommerce will pop a one-time download dialog.

Copy two values: Store Hash and Access Token

From the credentials dialog (or the downloaded .txt), grab:

• Store Hash — the 7-character string in the API Path URL, e.g. abcd123 from https://api.bigcommerce.com/stores/abcd123/v3/.
• Access Token — the long token starting with letters/numbers. BC only shows this once; if you lose it you have to regenerate.

Add a BigCommerce channel

In Foundry, go to Sales Channels → Add Channel. Name it (e.g., "My BC Store"), pick BigCommerce as the platform, set direction to Outbound, and click Create.

Paste the API credentials

On the channel's Settings page, fill in Store Hash and Access Token from step 2, then click Save Credentials. Foundry validates the connection on save — if anything's off you'll see a clear error message immediately.

Webhooks register automatically

As soon as valid credentials are saved, Foundry registers store/order/created, store/order/statusUpdated, and a few inventory webhooks on your BC store. No manual setup required. The Webhook Health card on the channel page shows the current status.

Turn on the sync options you want

Same settings page:

• Auto-Sync — push inventory changes to BC automatically.
• Order Sync — import new BC orders into Foundry. Pick which BC order statuses to include (default: everything past "Awaiting Fulfillment").
• Image Sync mode — pick Off, Append, or Replace. Replace mirrors Foundry's variant images to BC every time you edit them.

Pull existing products

Click Pull Products on the channel page. Foundry imports your BC product catalog as Channel SKUs. From there you can link them to existing Foundry products or promote them into new ones.

Place a test order

Place an order on your BC storefront (or use BC's test order helper). Within ~5 seconds it should appear in Foundry's Orders page tagged with the channel name. Reservations are created immediately so the inventory math stays correct.

List a Foundry product to BC

Open any Foundry product, click List, pick the BC channel, choose a category, and confirm. Within a few seconds the product is live on BC with its images, price, inventory, and any custom-field mappings you set up. Subsequent edits in Foundry sync automatically.

"Invalid credentials" on save

Double-check that the Store Hash is just the 7-char ID (not the full URL) and the Access Token has no leading/trailing whitespace. If you regenerated the token in BC, the old one is dead — paste the new one.

Webhooks show as "unreachable" in the health card

BC's webhook system retries failures for a while, then disables the hook. Usually this means your channel credentials were rotated, or BC's webhook delivery is having issues. Click Re-register webhooks on the channel page to recreate them.

A listing pushed but images didn't appear

BC fetches image URLs at listing-create time. If your Foundry variants don't have images yet, the listing publishes without them. Add images to the variant, then either re-list the product (delete the BC listing and click List again) or flip the channel's Image Sync mode to Replace and use the Sync images now button to backfill.

Orders aren't importing

Check the Order Import section of the channel settings — make sure the order statuses you want included are checked. By default Foundry imports orders from "Awaiting Fulfillment" forward; if your shop uses a custom status flow, adjust the filter.