MixDorm Connectivity · Partner API

Connect your PMS or
channel manager

One integration surface. Push live rates and availability directly from your system. Receive confirmed bookings the moment guests pay on MixDorm. No manual work after onboarding.

Request access About MixDorm

Verified Cloudbeds Distribution PartnerNative myAllocator Channel

API categories

Three surfaces cover everything a PMS or channel manager needs.

Content

Properties, room types, rate plans. Fetch your mapped room list and rate plan IDs during setup. Use these IDs in every ARI update.

GetRoomTypesGetRatePlansSetupProperty

Rates & Availability

The core push channel. Send real-time inventory, rates, and restrictions per room / date / rate plan. MixDorm indexes each update instantly.

ARIUpdate

Inventory[], ota_room_id, ota_rate_id, units, rate, closearr, closedep

Reservations

MixDorm pushes confirmed reservations to your webhook. You can cancel on-property bookings back to MixDorm, and pull full booking details on demand.

BookingCreateBookingRetrieveCancelBooking

Supported formats

The JSON API is available now. XML is provided for PMS systems that require an OTA/HTNG interface.

JSONAvailable now

OTA 2003B / HTNG XMLAvailable on request

Auth model

No OAuth. No Bearer tokens. Three fields in the JSON body of every request.

Required in every request body

shared_secretper-property — never log

ota_cidyour channel identifier

ota_property_idscopes request to one property

guidUUID v4 — idempotency key

Credentials are per-property and issued at onboarding. shared_secret is redacted from all MixDorm internal logs. All endpoints return HTTP 200 — parse success to determine outcome.

How to connect

Four steps from first email to live bookings.

Email us

Send your PMS name and a test property to team@mixdorm.com. We create the PMSPropertyMapping on our side.

Receive credentials

You get a channel slug, per-property shared_secret, ota_cid, and ota_property_id. Room and rate-plan IDs come via GetRoomTypes / GetRatePlans.

Configure your PMS

Register https://api.mixdorm.com/{channel}/webhook as your MixDorm base URL. Include shared_secret + ota_cid in every JSON body.

HealthCheck → ARI → live

Run HealthCheck to confirm credentials, push your first ARIUpdate, receive a test booking. Pass the pre-live checklist and go live.

Documentation

Full technical reference for each API surface.

Authentication

shared_secret, ota_cid, per-property credentials

Rates & Availability

ARIUpdate full field reference with request/response examples

Reservations

BookingCreate payload, BookingRetrieve, CancelBooking

Content

GetRoomTypes, GetRatePlans, property setup

Test-Property Tutorial

Step-by-step sandbox walkthrough with curl examples

OpenAPI 3.0 Spec

Machine-readable schema for code generation

Full docs available at docs/connectivity/ in the repo, or email team@mixdorm.com and we'll send them directly.

Ready to connect?

Email us with your PMS name and a test property. We provision sandbox credentials within one business day and walk you through the onboarding checklist.

team@mixdorm.comor fill out the form on our About page