Webhooks let you receive automatic notifications whenever something relevant happens in your MOGU account (a trip is created, a new booking comes in, a payment is completed, and so on). Your system can react instantly, with no need to poll the platform periodically.
Where do I find Webhooks?
From your MOGU account, go to Settings (the gear icon in the side menu) and click the Integrations tab. You'll find the Developer Tools section with the Webhooks option.
ℹ️ This feature is only available to our Enterprise customers. If you're not on Enterprise yet, contact [email protected] to upgrade your plan.
Add an endpoint
Click Add endpoint and complete the form in two steps.
Step 1 of 2: New endpoint
Name: an identifier that helps you recognize this endpoint (e.g. "My integration")
Endpoint URL: the address of your server that will receive the events. HTTPS only.
Events to subscribe: select at least one event from the list.
Once you're done, click Create endpoint
Step 2 of 2: Save your signing secret
Important! After creating the endpoint you'll see the signing secret. ⚠️ This secret will not be shown again. Copy it now and store it somewhere safe. Your technical team will need it to verify that each event comes from MOGU.
Click the clipboard icon to copy the secret.
Check the box "I have saved the secret in a safe place".
Click Done.
❗ If you don't copy the secret now, you'll have to rotate it to generate a new one.
View and manage your endpoint
Each endpoint shows:
The Name.
The Events it's subscribed to.
A status indicator: Active (green) or Paused (orange).
The Last delivery with its result (
200 OKif successful, or the error code received).
Send a test event
To check that your endpoint is properly connected:
On the endpoint card, click Send test.
MOGU will send a synthetic event (
webhook.test) to your URL.You'll see the result on screen: whether your server responded correctly or an error occurred.
💡 You can send a test even if the endpoint is paused. It's useful for validating URL changes.
Pause or reactivate an endpoint
If you need to stop receiving events temporarily (for maintenance, deployments, etc.):
Pause: use the switch on the card. Confirm in the "Pause this endpoint?" dialog. You'll stop receiving events until you reactivate it.
Reactivate: toggle the switch again and confirm. Events will resume immediately.
⚠️ Events generated while the endpoint is paused are not re-sent when you reactivate it.
Edit an endpoint
Click Edit to change:
The name
The URL (must remain HTTPS).
The list of subscribed events.
The signing secret is preserved: you don't need to reconfigure anything on your server unless you change the URL.
Rotate the signing secret
If you suspect your secret has been compromised, or simply want to rotate it periodically:
Click Rotate secret.
Confirm in the dialog.
Copy the new secret and hand it to your technical team.
ℹ️ Your team has 24 hours to update the secret before the old one expires. During this period, both secrets are valid, so you can migrate without interrupting event delivery.
Delete an endpoint
If you no longer need an endpoint:
Click Delete.
Confirm the action.
❗ This action cannot be undone. Your system will immediately stop receiving events from MOGU.
What events can I receive?
Trips: creation, edits, and changes saved in the builder.
Bookings: new bookings, cancellations, and traveler changes.
Payments: successful, failed, and refunded payments.
📘 See the full event catalog, the payload structure, and code examples in our technical documentation: api-docs.moguplatform.com/webhooks.
For your technical team
This guide is aimed at setting up and managing Webhooks from the UI. If your team needs to integrate the events into your system, our developer documentation has all the details:
Full payload structure for each event.
HTTP headers (`X-Mogu-Event`, `X-Mogu-Delivery`, `X-Mogu-Signature-256`).
How to verify the HMAC-SHA256 signature (Node.js and Python examples).
Best practices: idempotency, event ordering...
Local development with ngrok or Cloudflare Tunnel.
👉 Webhooks API documentation at api-docs.moguplatform.com/webhooks
What can I use Webhooks for?
Sync bookings and payments with your CRM or ERP.
Trigger automations (emails, SMS, internal notifications).
Feed dashboards and analytics systems in real time.
Integrate MOGU with any internal system without constantly polling the API.
💡 Webhooks don't replace our public API — they complement it. Use webhooks to react to events, and the API to query or modify data.