Skip to content
Docs

Connect WooCommerce

Updated 2026-11-18 · 2 min read

On this page
  1. Option 1: one-click authorization
  2. Option 2: paste REST API keys
  3. How it syncs
  4. FAQ
  5. Authorization fails with a pretty-permalink error.
  6. Webhooks show as failing.

To connect WooCommerce, go to Stores → Connect a store, choose WooCommerce, enter your store URL and approve the key request in WooCommerce. If you prefer, you can paste a REST API consumer key and secret with Read/Write permission instead.

Option 1: one-click authorization

  1. In Folio, open Stores → Connect a store and choose WooCommerce.
  2. Enter your store URL, for example https://shop.example.com.
  3. Folio sends you to your store’s WooCommerce authorization page. Sign in as an administrator if asked.
  4. Review the request and approve it. WooCommerce creates an API key and sends it to Folio.
  5. You return to Folio. Choose an import start date and confirm.

Option 2: paste REST API keys

  1. In WordPress, open WooCommerce → Settings → Advanced → REST API and add a key.
  2. Set permissions to Read/Write and create it. Copy the consumer key and consumer secret.
  3. In Folio, choose WooCommerce, enter your store URL, and paste the key and secret.
  4. Folio checks the keys against your store before saving them.

How it syncs

Folio reads orders through the WooCommerce REST API (v3). Read/Write access lets Folio create webhooks for order.created, order.updated and order.deleted through the same API. Each webhook is verified with an HMAC-SHA256 signature.

FAQ

WooCommerce needs permalinks other than “Plain” for the REST API. Change them in Settings → Permalinks and try again.

Webhooks show as failing.

Check that the store accepts incoming POST requests and see Troubleshooting sync.

Still stuck? Visit support or contact us.

Cookie preferences

Read our cookie policy