Webhooks

API, Automation, Bookings, Communications

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",
            "provider": "Stripe",
            "externalId": "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.

API, Automation, Bookings, Communications

You may also like

Managing Bookings in Mangobeds

Managing Bookings in Mangobeds

Keeping bookings tidy shouldn’t feel like rocket science. Mangobeds lets you edit, extend, and cancel stays in seconds, no spreadsheets, no stress. 1. Get into the booking Go to the bookings section and then open a booking from the calendar, the list, or just smash...

Split & Extend Bookings in Mangobeds

Split & Extend Bookings in Mangobeds

Long-stay guests switch rooms, add nights, or chop their stay in half all the time. Instead of juggling spreadsheets, do it in one flow inside the booking. How it works Open the bookingHead to Bookings → select the guest → Edit. Add a new unitIn Units Booked, hit +...