Common Wix Events for CLI Event Extensions
This reference lists common event types, SDK imports, permissions, and links. For full payload shapes and additional events, see the JavaScript SDK reference.
CRM Events
| Event | Import | Handler Call | Permission | API Reference |
|---|---|---|---|---|
| Contact created | import { contacts } from "@wix/crm" |
contacts.onContactCreated(handler) |
SCOPE.DC-CONTACTS.READ-CONTACTS |
onContactCreated |
| Contact updated | import { contacts } from "@wix/crm" |
contacts.onContactUpdated(handler) |
SCOPE.DC-CONTACTS.READ-CONTACTS |
onContactUpdated |
| Contact deleted | import { contacts } from "@wix/crm" |
contacts.onContactDeleted(handler) |
SCOPE.DC-CONTACTS.READ-CONTACTS |
onContactDeleted |
eCommerce Events
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 |
| Order approved | import { orders } from "@wix/ecom" |
orders.onOrderApproved(handler) |
SCOPE.DC-STORES.READ-ORDERS |
onOrderApproved |
| Order canceled | import { orders } from "@wix/ecom" |
orders.onOrderCanceled(handler) |
SCOPE.DC-STORES.READ-ORDERS |
onOrderCanceled |
| Refund created | import { refunds } from "@wix/payments" |
refunds.onRefundCreated(handler) |
SCOPE.DC-PAYMENTS.READ-REFUNDS |
onRefundCreated |
| Refund updated | import { refunds } from "@wix/payments" |
refunds.onRefundUpdated(handler) |
SCOPE.DC-PAYMENTS.READ-REFUNDS |
onRefundUpdated |
| Cart created | import { cartV2 } from "@wix/ecom" |
cartV2.onCartCreated(handler) |
SCOPE.DC-STORES.READ-ORDERS |
onCartCreated |
| Cart updated | import { cartV2 } from "@wix/ecom" |
cartV2.onCartUpdated(handler) |
SCOPE.DC-STORES.READ-ORDERS |
onCartUpdated |
Bookings Events
| 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 |
| Booking canceled | import { bookings } from "@wix/bookings" |
bookings.onBookingCanceled(handler) |
SCOPE.DC-BOOKINGS.READ-CALENDAR-WITH-PARTICIPANTS |
onBookingCanceled |
Blog Events
| Event | Import | Handler Call | Permission | API Reference |
|---|---|---|---|---|
| Post created | import { posts } from "@wix/blog" |
posts.onPostCreated(handler) |
SCOPE.DC-BLOG.READ-BLOGS |
onPostCreated |
| Post updated | import { posts } from "@wix/blog" |
posts.onPostUpdated(handler) |
SCOPE.DC-BLOG.READ-BLOGS |
onPostUpdated |
Payload Shape
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.