Docs›Developers

Using the Mangobeds API

2 min read

The Mangobeds API lets your own tools work with your Mangobeds data: your bookings, availability and rates, your guests, the messages you send them, and your payments. Use it to build your own dashboard, feed a CRM or a newsletter, take bookings from a site we do not host, or automate the parts of your operation that live outside Mangobeds.

Getting Started

To start using the Mangobeds API, you’ll need an API key to authenticate your requests.

  1. Generate Your API Key:
    • Log in to your Mangobeds account.
    • Navigate to Your Organization.
    • Go to Settings > API Keys.
    • Click Generate API Key.
    • Copy and store it securely, as it will be required for all requests.
  2. API Base URL:
    • All requests should be sent to: https://api.mangobeds.com

Working with the API

Authentication

All API requests require authentication using your API key. Include it in the request headers like this:

GET /bookings
Host: api.mangobeds.com
X-API-Key: your-api-key-here

Without a valid API key, your requests will be rejected.

What you can do with the API

  • Bookings: read a booking with its guests, units, dates, prices and payments, search a property’s bookings by guest name, email or channel reference, or by date range, and create new bookings with their units and guests.
  • Availability: check what is free per accommodation over any date range, the same picture we send to the channels, and read the blocked dates on your units so your own tools show exactly what your calendar shows.
  • Accommodations and rates: read your accommodations with their units and capacity, your seasonal rates, and the nightly price for any range of dates.
  • Guests: list and search the guests of a property with their contact details and custom guest fields, open one to see the bookings they are part of, correct or complete their details, and add a guest to a booking. Everything changed this way is recorded in the booking’s activity as coming from the API.
  • Messages to guests: list the communications you have set up on a property and send any of them to a booking, by email or WhatsApp, with the booking’s details filled in exactly as when you send it from Mangobeds.
  • Payments: record a payment you already received, such as cash or a bank transfer, or create a payment link to send to the guest.
  • Your organization: read your organization and the properties in it, which is where every other call starts.

The full reference

Every endpoint, with its parameters and example requests and responses, is in the Mangobeds API reference. It opens with your Mangobeds account, so there is no separate link or password to keep, and you will find it next to your API key in your organization settings.

Prefer plain language?

If you would rather ask than code, the same data is available to AI assistants through MCP. Connect Claude, ChatGPT or Cursor with the same API key and ask about your bookings, availability and guests in plain language, or have them send one of your messages to a booking. See Connect Mangobeds to AI tools with MCP.

Conclusion

With the Mangobeds API, you can automate your place management and streamline operations. If you need help or specific endpoint guidance, reach out to support@mangobeds.com.

Happy coding!