skills.rest
thisisjaymehta
thisisjaymehtaCOMMUNITY
Explore all skills by this author →
Website𝕏@thisisjaymehtaGitHub

wix-cli-backend-event

Create backend event extensions that respond to Wix site events via SDK webhooks.

Updated Mar 20, 2026
Search Tags:#cli#sdk#extension#webhook#event handler#wix#backend event
One-click install
npx skills add https://github.com/thisisjaymehta/login-with-email-test --skill wix-cli-backend-event-thisisjaymehta
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wix-cli-backend-event
Source: https://github.com/thisisjaymehta/login-with-email-test/tree/main/.agents/skills/wix-cli-backend-event
Command: npx skills add https://github.com/thisisjaymehta/login-with-email-test --skill wix-cli-backend-event-thisisjaymehta

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building backend logic that reacts to Wix site activity (new contacts, orders, bookings, blog posts) requires correctly wiring SDK webhook handlers, extension builder files, and registration in the Wix CLI project structure, which is error-prone without guidance. ## Core Features & Use Cases - Event Extension Scaffolding: Generates the two required files per event: a handler file importing the SDK event and an extension builder file using extensions.event() with a unique UUID. - Extension Registration: Ensures the event is imported and registered in src/extensions.ts so it actually activates. - Common Events Reference: Provides SDK imports, handler calls, and required permissions for CRM, eCommerce, Bookings, and Blog events. - Use Case: When a customer places an order on a Wix site, automatically run backend logic such as syncing the order to an external CRM or sending a notification. ## Quick Start Create a Wix CLI backend event extension that logs a message whenever a new contact is created on the site.

Frequently Asked Questions about wix-cli-backend-event

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a backend event extension in a Wix CLI app?▼

Create a folder under src/extensions/backend/events/<event-name>/ containing a handler file that imports the SDK event and an extension file calling extensions.event() with a unique UUID. Then register the extension in src/extensions.ts using .use().

How do I handle Wix events like contact created or order approved?▼

Import the relevant module such as contacts from @wix/crm or orders from @wix/ecom, then call the event method like contacts.onContactCreated(handler) with your handler function. The handler receives the event payload and metadata when the event fires.

Why is my Wix event extension not triggering?▼

Common causes include missing registration in src/extensions.ts, not releasing a new app version, or lacking the required permission scopes configured in the app dashboard. Also verify no duplicate handler exists for the same event, since only one handler per event is allowed.

Can I have multiple handlers for the same Wix event?▼

No, only one handler per event is allowed across the entire app, including handlers configured in the Wix dashboard. Attempting to add a second handler for the same event will conflict.

How do I call Wix APIs with elevated permissions inside an event handler?▼

Use auth.elevate from @wix/essentials to wrap the API call so it runs with the required permissions. For example, const elevatedQuery = auth.elevate(items.query) lets you query data collections from within the handler.

Related Skills

Explore More Software Engineering Skills→
ESSSoWhatESSSoWhat

wix-cli-data-collection

Creates CMS data collection schemas for Wix CLI apps using TypeScript extension definitions.

Community
Intermediate
wixwix
25

wix-cli-backend-event

Create and register Wix event extensions with handlers for backend workflows.

Official
Intermediate
nirganonnirganon

wix-cli-backend-event

Creates backend event extensions that respond to Wix site events via SDK webhooks.

Community
Intermediate
kamp-uskamp-us
25

adr

Record architecture decisions into structured markdown files via command-line input.

Official
Advanced