Set up webhooks for your app

Setting up webhooks requires you to add two settings to your Ecwid app:

• List of webhook events

• Self-hosted webhookUrl endpoint

If you don't yet have an app for Ecwid API access, start with the following instructions.

Everything that happens in the store has its webhook event. The event describes the affected entity and action in the entity.action format.

For example, order.created webhooks notify about any new orders in the store:

• Placed by customers on the storefront.

• Created by the store owner through the mobile app.

• Synced through applications with REST API.

We recommend you avoid enabling all webhook events for your app. Check out available events and choose the ones you need. List of webhook events

Your webhookUrl endpoint must work through HTTPS and must be able to receive POST requests and respond to them with HTTP 200 OK status.

Once you have both the webhookUrl and a list of events, request an application update.

Learn about handling webhooks:

How to process webhooks

Request application update:

Contact Ecwid API support team

If you need additional authentication on your side, you can set up custom headers for your webhookUrl. Learn more about custom headers.