Webhooks

Mangobeds webhooks allow you to receive real-time notifications about specific events related to your property. This guide will walk you through setting up and managing webhooks for your Mangobeds property.

Setting Up Webhooks

  1. Navigate to Webhooks:
    • Go to the Apps section in your Mangobeds dashboard.
    • Select the Webhooks app.
  2. Create a New Webhook:
    • Click the New button to create a new webhook.
  3. Enter Endpoint URL:
    • In the Endpoint URL field, enter the URL where you want to receive the webhook notifications.
  4. Select Events:
    • Choose the events you want to subscribe to. The available events are:
      • booking.confirmed: Triggered when a booking is confirmed.
      • booking.updated: Triggered when a booking is updated.
      • booking.canceled: Triggered when a booking is canceled.
  5. Save the Webhook:
    • Click Save to register the webhook.

Testing Webhooks

  1. Trigger Event:
    • To test a webhook, click the Trigger Event button.
    • Select the event you want to test (e.g., booking.confirmed).
  2. View Response:
    • The response window will show the details of the triggered event and the payload sent to your endpoint.

Webhook Body

When an event occurs, Mangobeds sends a POST request to the specified endpoint URL with a body that includes the event and payload.

Below is an example of the body for the booking.confirmed event:

{
      "event": "booking.confirmed",
      "payload": {
        "propertyId": "clx741jp60001we5pk2yhv9a6",
        "bookingId": "we5pk2yhv9a6clx741jp60001",
        "status": "Confirmed",
        "createdAt": "2024-05-14T15:44:34.562Z",
        "startDate": "2024-06-06T15:44:34.562Z",
        "endDate": "2024-06-20T15:44:34.562Z",
        "guests": [
          {
            "name": "Joé Veber",
            "email": "joey@indacloudsss.com",
            "phone": "+33612345678",
            "address": {
              "line1": "3 Rue Louis Fauré",
              "city": "Briançon",
              "state": "Briançon",
              "postalCode": "05100"
            },
            "country": "FR",
            "isMainGuest": true
          }
        ],
        "totalPrice": 100,
        "units": [
          {
            "unitName": "Double Room 1"
          }
        ],
        "payments": [
          {
            "paymentId": "we5pk2jp60001yhv9a6clx741",
            "stripePaymentIntentId": "pi_3P3gliD1dvZgGttz0SpiG6ki",
            "createdAt": "2024-05-14T15:44:34.562Z",
            "amount": 100
          }
        ],
        "source": {
           "origin": "Airbnb",
           "externalId": "HM2J82JHD"
        }
      }
    }

For any questions or further assistance, contact our support team.

You may also like

Know Your Guests Inside‑Out with Mangobeds CRM

Know Your Guests Inside‑Out with Mangobeds CRM

Running a coliving means juggling check‑ins, events, and that one guy who always asks for oat milk at 2 a.m. Remembering it all? Impossible, until now. Guest Profiles 🗂️ Every booking auto‑generates a profile that stores email, phone, past stays, spend, allergies,...

Simplify Your Legal Obligations in Portugal with Hostkit and Mangobeds

Simplify Your Legal Obligations in Portugal with Hostkit and Mangobeds

Running your space in Portugal? You’re probably juggling bookings and legal paperwork like SEF, Modelo 30, invoices, and city tax. Not fun. That’s where Hostkit comes in — a powerful tool built to automate all your legal and fiscal tasks while you manage your bookings...

More Ways to Get Paid, Better Insights & Handy New Tools

More Ways to Get Paid, Better Insights & Handy New Tools

We’ve been cooking up fresh features to improve your coliving management. From simpler payment flows and deeper analytics to our shiny new affiliate program, here’s what’s new at Mangobeds! Payment Links & New Payments App No more confusion when you need a quick...