🔔 Konvex Webhooks Subscription

post

https://api.getkonvex.com/core/api/webhooks

This endpoint (POST /core/api/webhooks) allows you to subscribe a single callback URL to receive real-time notifications about key events occurring across your e-commerce platforms.

By unifying events under consistent names, we simplify integration, regardless of the source platform (Shopify, WooCommerce, VTEX).

🎯 Unified Event List and Platform Availability

Use the Unified Event name for the topics field in your request body. The table below indicates whether the event is available on the corresponding platform.

Orders (`orders` & `refunds`)

Unified Event	Shopify	WooCommerce	VTEX
`orders.created`	Available	Available	Available
`orders.updated`	Available	Available	Available
`orders.paid`	Available	Available	Available
`orders.fulfilled`	Available	N/A	Available
`orders.partially_fulfilled`	Available	N/A	N/A
`orders.cancelled`	Available	Available	Available
`refunds.created`	Available	Available	N/A

Fulfillment Management (`fulfillment_orders`)

Unified Event	Shopify	WooCommerce	VTEX
`fulfillment_orders.request_submitted`	Available	N/A	Available
`fulfillment_orders.request_accepted`	Available	N/A	Available
`fulfillment_orders.cancellation_submitted`	Available	N/A	N/A
`fulfillment_orders.cancelled`	Available	N/A	N/A

Checkouts and Draft Orders

Unified Event	Shopify	WooCommerce	VTEX
`checkouts.created`	Available	N/A	N/A
`checkouts.updated`	Available	N/A	N/A
`draft_orders.created`	Available	N/A	N/A
`draft_orders.updated`	Available	N/A	N/A

Customers (`customers`)

Unified Event	Shopify	WooCommerce	VTEX
`customers.created`	Available	Available	N/A
`customers.updated`	Available	N/A	N/A
`customers.deleted`	Available	N/A	N/A
`customers.tags_added`	Available	N/A	N/A
`customers.purchasing_summary`	Available	N/A	N/A

Products and Inventory

Unified Event	Shopify	WooCommerce	VTEX
`products.created`	Available	N/A	N/A
`products.updated`	Available	Available	N/A
`products.deleted`	Available	N/A	N/A
`inventory_levels.updated`	Available	N/A	N/A

App Lifecycle

Unified Event	Shopify	WooCommerce	VTEX
`app.uninstalled`	Available	N/A	N/A

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

forward_url

string

required

The HTTPS URL where our system will send the webhook notifications in real-time. This is the endpoint on your server that must be ready to receive and process the event data. Shopify Vtex Woo-commerce

topics

array of strings

required

A list of Unified Event Names (or topics) you wish to subscribe to. Our system will map these unified names to the specific webhooks available in the connected e-commerce platform (Shopify, WooCommerce, or VTEX). Refer to the Unified Event List for all available values (e.g., orders.created, customers.updated). Shopify Vtex Woo-commerce

topics*

Headers

x-software

string

enum

required

Name of the platform from which you want to subscribe webhooks Shopify Vtex Woo-commerce

Allowed:

x-connection

string

required

If you send the x-connection, the connection will already be secured, and there will be no need to send the connection headers for each software. Optional for: Shopify Vtex Woo-commerce

Responses

200200

400400