Wix Webhooks

asyncapi: 2.6.0
info:
  title: Wix Webhooks
  version: "1.0"
  description: |
    AsyncAPI specification for the documented Wix webhook surface. Wix delivers
    webhook events as signed JSON Web Tokens (JWTs) POSTed to subscriber URLs
    registered in the Wix Dev Center. The JWT body decodes into a common envelope
    (id, entityFqdn, slug, entityId, eventTime, originatedFrom,
    triggeredByAnonymizeRequest) plus an event-specific data payload (actionEvent,
    createdEvent, updatedEvent or deletedEvent) whose contents depend on the
    triggering action.

    Channels in this document are addressed by the entityFqdn plus event slug
    documented for each webhook. Only events that are explicitly documented at
    dev.wix.com are modeled here. Payload field details beyond the common envelope
    vary per resource and should be confirmed against the linked Wix documentation
    page for each event.
  contact:
    name: Wix Developer Platform
    url: https://dev.wix.com/docs/rest
  license:
    name: Wix Terms of Service
    url: https://www.wix.com/about/terms-of-use
  externalDocs:
    description: About Wix Webhooks
    url: https://dev.wix.com/docs/build-apps/develop-your-app/api-integrations/events-and-webhooks/about-webhooks

defaultContentType: application/jwt

servers:
  subscriber:
    url: '{webhookUrl}'
    protocol: https
    description: |
      Subscriber endpoint configured for the Wix app in the Wix Dev Center.
      Wix POSTs a signed JWT to this URL when a subscribed event fires.
      Implementations must respond within 1250ms with a 2xx status. Wix retries
      up to 12 times on failure.
    variables:
      webhookUrl:
        default: https://example.com/wix/webhooks
        description: Fully-qualified HTTPS endpoint registered as the webhook receiver.

tags:
  - name: Stores
    description: Wix Stores catalog, products and inventory webhooks.
  - name: eCommerce
    description: Wix eCommerce cart, checkout, orders and transactions webhooks.
  - name: Bookings
    description: Wix Bookings v2 bookings and services webhooks.
  - name: Members
    description: Wix Members and Members Badges webhooks.
  - name: Contacts
    description: Wix Contacts v4 webhooks.
  - name: Forms
    description: Wix Forms submission webhooks.
  - name: PricingPlans
    description: Wix Pricing Plans plan and order lifecycle webhooks.
  - name: Events
    description: Wix Events v3 events, RSVP, orders, ticket definitions and reservation webhooks.
  - name: Blog
    description: Wix Blog post and draft post webhooks.
  - name: Coupons
    description: Wix Coupons webhooks.
  - name: Loyalty
    description: Wix Loyalty Program account and points webhooks.


# --- truncated at 32 KB (60 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/wix/refs/heads/main/asyncapi/wix-asyncapi.yml