Why webhooks

Scheduled cron import (see Commerce live import) can lag minutes or hours. Inventory webhooks push stock changes within seconds when someone buys on Shopify/Woo or staff adjusts quantity in the external admin.

Shopify setup

1. In Commerce → Import, save a Shopify live connection (store URL + access token).
2. Open Inventory webhooks (or Import → Webhooks).
3. Copy the webhook URL and signing secret shown for Shopify.
4. In Shopify Admin → Settings → Notifications → Webhooks, create:

- Topic: Inventory levels update - URL: paste Birkly webhook URL - Format: JSON

1. Paste Shopify's shared secret into Birkly and click Save.
2. Use Rotate secret if you regenerate the Shopify secret.

WooCommerce setup

1. Save a WooCommerce REST connection in Commerce import settings.
2. Copy the Woo webhook URL and secret from Birkly.
3. In WordPress → WooCommerce → Settings → Advanced → Webhooks:

- Topic: Product updated - Delivery URL: Birkly webhook URL - Secret: match Birkly stored secret

1. Save on both sides.

What gets updated

• Commerce catalog index entries whose SKU matches the payload
• Warehouse stock row for the same SKU (if configured — see Commerce warehouse stock)
• Entries without a matching SKU are skipped (no error to the platform)

Security

• Unsigned or invalid HMAC requests are rejected with HTTP 401.
• Rotate secrets from Commerce admin when staff leave or after a leak.
• Webhooks are inbound-only — Birkly never writes stock back to Shopify/Woo in v1.