Who This Is For / When to Use
Use this article if you want to:
Sync WooCommerce contacts, orders, transactions, and products into Kyrios
Use WooCommerce order and payment triggers in workflows
Centralize e-commerce data for automation and reporting
What the WooCommerce Integration Does
The WooCommerce integration imports and syncs data from your WooCommerce store into Kyrios.
Supported data includes:
Contacts (customers and guest checkouts)
Orders
Transactions
Products and categories
WooCommerce acts as the source of truth for synced product data.
Key Features
Data Syncing: Import contacts, orders, transactions, products, and categories.
Automation Triggers: Use triggers like Order Submitted and Payment Received in workflows.
Custom Sync Controls: Enable or disable syncing per data type.
Guest Checkout Support: Automatically creates contacts for guest orders.
Error Handling: Authentication errors automatically trigger a reconnect state with email instructions.
Important Data Rules and Limitations
Contact and Customer Rules
Only WooCommerce users with the roles Customer or Subscriber are imported.
If Contact Sync is disabled but Order Sync is enabled, contacts are still created for orders.
Guest checkout contacts are created once and do not sync future updates.
Order Status Mapping
WooCommerce order statuses map as follows:
Completed or Refunded → Completed
Cancelled or Failed → Cancelled
All other statuses → Pending
Orders synced from WooCommerce display a WooCommerce subtype in order details.
Product and Category Limitations
Only Simple and Variable products are imported.
Products with a zero price or no variants are excluded.
Only published products are imported.
The Include in Online Store toggle is enabled only for published products.
Only categories linked to products are imported.
Product and category deletions in WooCommerce do not sync to Kyrios.
Step 1: Access the WooCommerce Integration
Go to Settings in Kyrios.
Select Integrations.
Locate WooCommerce.
Click Connect.
Step 2: Enter Your WooCommerce Store URL
Enter your WooCommerce store URL.
Use the format
https://yourstore.com.Do not include a trailing slash.
Click Next.
Step 3: Import Initial Data
Select which existing WooCommerce data to import.
Available import options:
Contacts
Orders
Transactions
Products
If you skip items during this step, you must disconnect and reconnect to import them later.
Step 4: Configure Ongoing Sync Settings
Choose which data should continue syncing from WooCommerce to Kyrios.
Available sync options:
Contact Sync
Order Sync
Transaction Sync
Order Received Trigger
Payment Received Trigger
Product Sync
Changes made in WooCommerce will reflect in Kyrios. Changes made in Kyrios do not sync back.
Step 5: Approve WooCommerce Permissions
Review the permissions requested.
Click Approve to complete the connection.
Step 6: Verify Synced Orders
After setup:
Orders synced from WooCommerce show Source: External.
Sub-Type displays as WooCommerce.
Using WooCommerce Triggers in Workflows
WooCommerce triggers allow automation based on store activity.
Order Submitted Trigger
Use this trigger when an order is placed in WooCommerce.
Payment Received Trigger
Use this trigger when a WooCommerce payment is received.
Example Use Case: Automating Store Communication
A store owner can:
Send order confirmation messages when an order is submitted.
Trigger thank-you messages when payment is received.
Create follow-ups for pending payments using order status logic.
These automations reduce manual work and improve customer experience.
Managing and Reimporting Data
Sync settings can be changed anytime from Settings > Integrations > WooCommerce.
To import additional historical data, disconnect and reconnect the integration.
Common Issues and Fixes
Authentication error (401, 403, 404)
The integration enters reconnect mode and sends email instructions.
Products missing after sync
Confirm products are published, priced, and are Simple or Variable types.
Guest orders not updating
Guest checkout contacts do not sync future updates.
FAQ
What data can I import from WooCommerce?
You can import contacts, orders, transactions, products, and product categories.
Does the integration support guest checkout orders?
Yes. Guest orders create contacts, but those contacts do not sync future updates.
How do I reimport missing data?
Disconnect and reconnect the WooCommerce integration to trigger a fresh import.
How are WooCommerce order statuses mapped?
Completed and Refunded map to Completed. Cancelled and Failed map to Cancelled. All others map to Pending.
Which product types are supported?
Only Simple and Variable products are imported.
Are unpublished products imported?
No. Only published products are imported.
What happens if authentication fails?
The integration enters reconnect mode and sends an email with reconnection steps.
Are deletions synced from WooCommerce?
No. Product and category deletions in WooCommerce are not synced to Kyrios.