Handle Account-Level Webhooks

This article explains how to subscribe to account-level webhooks and handle events on your server.

Note: Account-level webhooks are available only for Wix Enterprise and Wix Channels partners.

Step 1 | Subscribe to a webhook

Subscribe to an account-level webhook from the Webhooks page in your Wix Studio workspace.

  1. In your Wix Studio workspace, go to Settings > Webhooks in the side panel.
  2. Click Create Webhook.
  3. Browse the event categories, then hover over an event and click Select Event.
  4. Click Code Sample to view sample code.
  5. Enter your callback URL. Click Trigger Test to verify your endpoint receives the event.
  6. Click Subscribe.

To test your new webhook, hover over the event and click Test. For more options, click the More Actions More Actions icon.

Step 2 | Save your public key

Wix sends webhook payloads in JSON Web Token (JWT) format. Your public key allows you to verify the signature in any webhook you receive.

To get your public key:

  • On the Webhooks page, click Get Public Key.
  • Copy it from the code sample provided when subscribing to a webhook.

Save the public key in a secure location. You need to use it in your handler to verify that the request is from Wix.

Step 3 | Handle the event

When an event you've subscribed to occurs, Wix sends a POST request to your callback URL with the event data in the request body. Your endpoint should return a 200 status code to acknowledge receipt.

The code sample you receive when creating a webhook includes everything you need to handle the event:

  • The handler code for processing the event payload.
  • A pre-configured public key for JWT verification.
  • The app ID that powers account-level webhook functionality.

Copy the code sample to your server and customize the event handler to implement your business logic.

Note: If you manage child accounts, events from those accounts also propagate to your callback URL. For details on distinguishing between parent and child account events, see About Account-Level Webhooks.

See also

Did this help?