How to connect your WooCommerce store

Connect your WooCommerce (WordPress) store to EcomUp to bring your products into EcomUp. The AI can then recommend them to customers, and new orders and product changes can sync automatically.

Before you start

• You need admin access to your WordPress site, and the WooCommerce plugin must be installed and active.
• Your store must be online at a public web address that starts with https://.
• In EcomUp, your role must be allowed to manage connections. Owners and admins can do this by default.
• No extra plugin is needed. You only create an API key in WooCommerce. An API key is a pair of codes that lets EcomUp talk to your store safely.

Part 1: Create an API key in WooCommerce

1. Log in to your store admin, for example https://your-store.com/wp-admin.
2. Go to WooCommerce → Settings.
3. Open the Advanced tab, then click REST API.
4. Click Add key (or Create an API key).
5. Type a Description, for example “EcomUp”, and pick your admin user under User.
6. Set Permissions to Read/Write.
7. Click Generate API key.
8. Copy the Consumer key (starts with ck_) and the Consumer secret (starts with cs_). The secret is shown only once, so copy it now.

Part 2: Connect the store in EcomUp

1. In EcomUp, go to Engage → Connections.
2. On the Available Platforms tab, find the WooCommerce card and click Connect.

   

3. In Store URL, enter your store address, for example https://yourstore.com.
4. Paste your keys into Consumer key and Consumer secret.
5. Click Connect WooCommerce. EcomUp checks the keys before saving.

   

6. When you see “WooCommerce connected — real-time sync enabled!”, you are done.
7. On the WooCommerce card, click Manage, then click Sync Products to import your catalog.

Tips

• You can run Sync Products any time. Existing products are updated, never duplicated. The Last sync result shows how many were imported, updated, skipped or failed.
• When Real-time updates is on, product, order and customer changes in WooCommerce reach EcomUp instantly. If it shows Manual sync only, click Enable real-time.
• Even without real-time updates, EcomUp syncs your store in the background every 6 hours.
• If you create new keys in WooCommerce, open the WooCommerce manage page and click Update Credentials.
• Disconnecting stops product sync. Products already synced stay in your EcomUp catalog.
• Click the small ? icon on the WooCommerce card to open the built-in step-by-step guide.

Troubleshooting

“Invalid credentials. Please check your Consumer Key and Consumer Secret.”

One of the keys is wrong or was deleted. Copy both keys again, or generate a new key in WooCommerce and paste it in.

“WooCommerce REST API not found. Please ensure WooCommerce is installed and REST API is enabled.”

Check that WooCommerce is active and that the Store URL is your main site address, without extra paths like /shop. In WordPress, set Settings → Permalinks to anything except “Plain”, then try again.

“Unable to connect to the provided store URL. Please check the URL and try again.”

The address is wrong or the site is offline. Open the URL in your browser to check it works, and include https://.

“Consumer key should start with ck_” or “Consumer secret should start with cs_”

You pasted the keys into the wrong boxes, or copied extra text. The key starts with ck_ and the secret starts with cs_.

“Connected — but real-time sync isn't on: …”

The store is connected, but EcomUp could not add its webhooks to your store. Make sure the API key has Read/Write permission, then click Enable real-time on the WooCommerce manage page. Until then, changes sync when you click Sync Products and every 6 hours.

For developers

EcomUp uses the WooCommerce REST API (wc/v3) with the Consumer key and secret you provide. Nothing needs to be installed on the store.

Webhooks EcomUp adds to your store

When real-time sync is enabled, EcomUp creates these webhooks under WooCommerce → Settings → Advanced → Webhooks. Each is named EcomUpAi <topic>, is signed with a secret, and points at EcomUp.

Topic	What syncs
product.created, product.updated, product.deleted	Products
order.created, order.updated, order.deleted	Orders
customer.created, customer.updated	Customers

Don't edit or delete these webhooks. If you remove them by mistake, click Re-register webhooks on the WooCommerce manage page.

Related articles

• Add products
• Manage orders
• AI sales agents
• Webhooks and integrations API