Setting the file. One moment.
Subchapter 2.29
references/backend-event/COMMON-EVENTS.mdMarkdown5 KBView on GitHub
This reference lists common event types, SDK imports, permissions, and links. For full payload shapes and additional events, see the JavaScript SDK reference.
| Event | Import | Handler Call | Permission | API Reference |
|---|---|---|---|---|
| Contact created | import { contacts } from "@wix/crm" | contacts.onContactCreated(handler) | SCOPE.DC-CONTACTS.READ-CONTACTS | onContactCreated (opens in a new tab) |
| Contact updated | import { contacts } from "@wix/crm" | contacts.onContactUpdated(handler) | SCOPE.DC-CONTACTS.READ-CONTACTS | onContactUpdated (opens in a new tab) |
| Contact deleted | import { contacts } from "@wix/crm" | contacts.onContactDeleted(handler) | SCOPE.DC-CONTACTS.READ-CONTACTS | onContactDeleted (opens in a new tab) |
Order events use @wix/ecom (namespace orders). Order refund events are the exception: they live in @wix/payments (namespace refunds), not @wix/ecom.
| Event | Import | Handler Call | Permission | API Reference |
|---|---|---|---|---|
| Order created | import { orders } from "@wix/ecom" | orders.onOrderCreated(handler) | SCOPE.DC-STORES.READ-ORDERS | onOrderCreated (opens in a new tab) |
| Order approved | import { orders } from "@wix/ecom" | orders.onOrderApproved(handler) | SCOPE.DC-STORES.READ-ORDERS | onOrderApproved (opens in a new tab) |
| Order canceled | import { orders } from "@wix/ecom" | orders.onOrderCanceled(handler) | SCOPE.DC-STORES.READ-ORDERS | onOrderCanceled (opens in a new tab) |
| Refund created | import { refunds } from "@wix/payments" | refunds.onRefundCreated(handler) | SCOPE.DC-PAYMENTS.READ-REFUNDS | onRefundCreated (opens in a new tab) |
| Refund updated | import { refunds } from "@wix/payments" | refunds.onRefundUpdated(handler) | SCOPE.DC-PAYMENTS.READ-REFUNDS | onRefundUpdated (opens in a new tab) |
| Cart created | import { cart } from "@wix/ecom" | cart.onCartCreated(handler) | SCOPE.DC-STORES.READ-ORDERS | onCartCreated (opens in a new tab) |
| Cart updated | import { cart } from "@wix/ecom" | cart.onCartUpdated(handler) | SCOPE.DC-STORES.READ-ORDERS | onCartUpdated (opens in a new tab) |
| Event | Import | Handler Call | Permission | API Reference |
|---|---|---|---|---|
| Booking confirmed | import { bookings } from "@wix/bookings" | bookings.onBookingConfirmed(handler) | SCOPE.DC-BOOKINGS.READ-CALENDAR-WITH-PARTICIPANTS | onBookingConfirmed (opens in a new tab) |
| Booking canceled | import { bookings } from "@wix/bookings" | bookings.onBookingCanceled(handler) | SCOPE.DC-BOOKINGS.READ-CALENDAR-WITH-PARTICIPANTS | onBookingCanceled (opens in a new tab) |
| Event | Import | Handler Call | Permission | API Reference |
|---|---|---|---|---|
| Post created | import { posts } from "@wix/blog" | posts.onPostCreated(handler) | SCOPE.DC-BLOG.READ-BLOGS | onPostCreated (opens in a new tab) |
| Post updated | import { posts } from "@wix/blog" | posts.onPostUpdated(handler) | SCOPE.DC-BLOG.READ-BLOGS | onPostUpdated (opens in a new tab) |
The event envelope structure varies by API — the path to the main entity differs (e.g., event.entity, event.data.order). Use TypeScript and your IDE for autocomplete and type safety. See each event’s API reference link above for the exact payload shape.
All envelopes include a metadata object with context such as event ID, entity ID, timestamp, and instance ID.