WooCommerce & integrations

WooCommerce API integration: REST, webhooks and HPOS

WooCommerce provides REST and webhook interfaces for external systems, but a production integration still needs a source-of-truth model, duplicate handling and failure recovery.

Reviewed 2026-08-09

Direct answer

WooCommerce’s current WordPress-integrated REST API uses v3 as the primary endpoint version. HPOS has been enabled by default on new installations since WooCommerce 8.2, so custom integrations should rely on supported WooCommerce APIs rather than direct post-table assumptions.

Current facts

Numbers and platform rules that matter to this answer.

REST APIv3 primarySource: WooCommerce
HPOSDefault on new installs since 8.2Source: WooCommerce

Answer scope

What this page helps you decide.

Who this is for

  • Teams planning WooCommerce-to-ERP, CRM, inventory or fulfillment integration.

What is covered

  • Current platform facts
  • Decision criteria
  • Cost and risk drivers
  • Questions to use when comparing proposals

What is not claimed

  • Not a fixed quote for every site
  • No guaranteed ranking, revenue or performance score
  • No recommendation to change production systems without a backup and rollback plan
01

Choose REST, webhooks or both

REST is useful for reading and changing resources, while webhooks can notify another system when an event occurs. Many integrations use webhooks for triggers and REST for reconciliation or enrichment.

The design should account for webhook retries and events that arrive more than once.

02

Map the authoritative system for each field

Products, prices, stock, customers and orders may have different owners.

A field-by-field ownership matrix prevents two systems from overwriting each other in a loop.

03

Use supported order APIs with HPOS

HPOS stores orders in dedicated WooCommerce tables and is the default for new installations from 8.2. Supported CRUD and REST APIs insulate integrations from storage differences.

Direct SQL against legacy post tables creates unnecessary compatibility risk.

04

Make processing duplicate-safe

Stable external IDs, order IDs or event IDs can help ensure retries do not create duplicate orders or apply stock twice.

Record the synchronization state so operations can distinguish waiting, completed and failed records.

05

Reconcile business-critical data

Periodic reconciliation can compare WooCommerce orders or inventory with the external system and flag mismatches that real-time events missed.

This is especially valuable when the integration crosses vendor APIs outside your direct control.

Questions

Frequently asked questions

What WooCommerce REST API version should I use?

WooCommerce currently documents v3 as the primary WordPress-integrated REST API version.

What is the difference between REST API and webhooks?

REST performs requests to read or modify data. Webhooks notify a destination when configured events occur.

Does HPOS break WooCommerce API integrations?

Supported REST/CRUD integrations should be insulated from the storage change. Code that directly assumes orders are WordPress posts may need changes.

Start a conversation

Need help applying this to a real website or system?

Send the current setup and the result you need. I will review the problem and suggest the most practical next step.

Chat on WhatsApp