Developer overview: what you can connect to EcomUp
Every way to connect your own website or tools to EcomUp: the Custom Store API and webhooks, chat widget, pixels and custom code.
This page is for you, or for the developer who builds your website. It lists every way you can connect your own systems to EcomUp today, and what each one is for. Most store owners won't need any of this: the online store and the WooCommerce connection work without code.
Is there a public EcomUp API?
Not a general one. EcomUp does not offer a full public REST API with access to everything in your account (for example, reading all orders or changing order statuses from outside). What it does offer is a set of focused integration points, listed below. If you need something that isn't here, tell us through Help & Support.
What you can connect
| You want to… | Use | Where to set it up |
|---|---|---|
| Send products, categories, customers and orders from your own website into EcomUp, and get notified when orders are created or change status | Custom Store (API key + signed webhooks) | Connections → Custom Store. Full guide: Webhooks and integrations API |
| Sync a WooCommerce store | Built-in connections, no code | Connect WooCommerce |
| Add EcomUp's AI chat to another website | Chatbot widget embed snippet | Chatbot widget |
| Track ads and conversions on your EcomUp store | Facebook, TikTok, GA4, Google Ads and GTM pixels | Tracking pixels |
| Add your own scripts or verification tags to your EcomUp store | Header and footer custom code | Custom code |
Custom Store at a glance
- Inbound API: five
POSTendpoints under/webhook/custom-store/for products, categories, customers, addresses and orders. - Authentication: one API key per EcomUp account, sent in the
x-api-keyheader. The key is shown only once, when you connect or regenerate it. - Outbound webhook: EcomUp sends a
POSTto your URL fororder.created,order.updated,product.created,customer.createdandcategory.created. - Security: every webhook delivery is signed with HMAC-SHA256 in the
X-EcomUp-Signatureheader, using a signing secret you can view in the dashboard.
Steps to get started
- In the left menu, open Connections.
- Find the Custom Store card and click Connect.
Find the Custom Store card (1) and click Connect (2). - On the Custom Store page, click Connect Custom Store.
- Copy your API key right away and keep it somewhere safe. It won't be shown again.
- Follow Webhooks and integrations API to send data and receive webhooks.
Tips
- The Custom Store page has built-in documentation with copy-ready examples in cURL, Node.js, PHP and Laravel. Click any endpoint to jump to its docs.
- Treat the API key and signing secret like passwords. Never put them in your website's front-end code or share them in chat.
- Managing a Custom Store needs the connections permission. Owners and admins have it by default.
Troubleshooting
The Connect Custom Store button is greyed out
Your role can't manage connections. Ask the account owner to connect it, or to give your role that permission. See Team members and roles.
I lost my API key
Keys are stored in a secure, hashed form, so EcomUp can't show it again. Click Regenerate on the Custom Store page and update your website with the new key.