skills.rest
ESSSoWhat
ESSSoWhatCOMMUNITY
Explore all skills by this author →
GitHub

wix-cli-backend-event

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

Updated Feb 21, 2026
Search Tags:#backend#cli#sdk#webhook#handler#wix#event extension
One-click install
npx skills add https://github.com/ESSSoWhat/live-translate-realtime-dubbing --skill wix-cli-backend-event-esssowhat
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wix-cli-backend-event
Source: https://github.com/ESSSoWhat/live-translate-realtime-dubbing/tree/main/wix-app/np/.agents/skills/wix-cli-backend-event
Command: npx skills add https://github.com/ESSSoWhat/live-translate-realtime-dubbing --skill wix-cli-backend-event-esssowhat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @wix/astro, @wix/essentials, @wix/crm, @wix/ecom, @wix/bookings, @wix/blog, @wix/data, and includes references (resource) components.

What problem does it solve? Building backend logic that reacts to Wix site activity—like a new contact, order, booking, or blog post—requires correctly wiring SDK event handlers, extension builders, and registration files, which is error-prone without guidance. ## Core Features & Use Cases - Event Extension Scaffolding: Generates the two required files (<event-name>.ts handler and <event-name>.extension.ts builder) with a unique UUID and correct extensions.event() configuration. - Common Event Reference: Provides SDK imports, handler calls, and required permissions for CRM, eCommerce, Bookings, and Blog events. - Permission Elevation: Shows how to use auth.elevate from @wix/essentials so API calls inside handlers run with proper permissions. - Use Case: When a customer places an order on a Wix store, automatically run custom logic such as syncing the order to an external CRM or sending a notification. ## Quick Start Ask the assistant to create a Wix backend event extension that runs custom logic 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 Wix backend event extension with the CLI?▼

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

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

Import the relevant module such as @wix/crm or @wix/ecom and call the event method, for example contacts.onContactCreated(handler) or orders.onOrderApproved(handler). The handler receives the event payload and metadata when the event fires.

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

No, only one handler per event is allowed in an app, including handlers configured in the dashboard. Attempting to register a second extension for the same event will conflict with the existing one.

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

Use auth.elevate from @wix/essentials to wrap the API method, for example auth.elevate(items.query). The elevated call then runs with the permissions required to access the resource.

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. Some events also cannot be fully tested in local development.

Related Skills

Explore More Software Engineering Skills→
nirganonnirganon

wix-cli-extension-registration

Registers Wix CLI extensions with the app builder in src/extensions.ts.

Community
Basic
exilonXexilonX

vtex-io-observability-and-ops

Add structured logging and integration metrics to VTEX IO backend services.

Community
Intermediate
openclawopenclaw
9.4k

convex-crons

Define recurring scheduled jobs in Convex using cronJobs and internal functions.

Official
Basic
divinaarmueladivinaarmuela

wix-headless

Configures Wix Headless backends and generates SDK integration guides for frontend applications.

Community
Advanced