Quick Start
Everything you need to begin building with SMX API.
SiteMinder Exchange (SMX) connects your application to SiteMinder's platform and Property Management Systems (PMS) through a single, standardised integration. Through SMX, your application can receive booking data, and retrieve real-time availability and rates.
API components:
Reservations: Receive reservations, modifications, and cancellations via SOAP PUSH
Availability and Rates: Retrieve publishers, hotels, room types, rate plans, availability, and rates via REST
Explore all components in the API Overview.
Before You Begin
Partnership Required
Access to SMX requires an active partnership agreement with SiteMinder. Once your agreement is in place, you will receive your test environment details.
You don't need to wait for your test environment to start development. You can begin building and testing immediately. See Make Your First Call below or explore requests directly in the Postman collection.
What You'll Provide to SiteMinder
Before SiteMinder can set up your test environment, provide the following:
Reservation SOAP endpoint
Your HTTPS endpoint URL for Reservations
Credentials
username and password for SiteMinder to authenticate against your Reservation SOAP endpoint
Hotel Code
HotelCode
What You'll Receive from SiteMinder
Once SiteMinder has received your details, we will provide:
Inventory REST endpoint
Partner Portal
Access to generate your Bearer Token for Availability and Rates
Hotel Test Account
Platform that includes pre-configured room types and rate plans, and to create, modify and cancel reservations.
Hotel Booking Engine
Guest reservation simulator.
Set Up Your Environment
Authentication
SMX uses two authentication models depending on the component:
Reservations (SOAP) — SiteMinder authenticates against your endpoint using the credentials you provide. Your endpoint must validate the wsse:UsernameToken on every incoming request:
Availability and Rates (REST) — Your application authenticates using a Bearer Token generated from the Partner Portal. Pass the token on every REST request:
Generate your Bearer Token from the Partner Portal. Once the dialogue box is closed, the token cannot be viewed again — copy it immediately and store it securely.
API Specification Files
REST (OpenAPI)
smx-api — download YAML
Make Your First Call
The first component every SMX integration must implement is Reservations — SiteMinder pushes reservation data to your endpoint as bookings are created, modified, or cancelled in the PMS. Your endpoint receives and processes these in real time.
SiteMinder pushes to your endpoint — it must be live and accepting incoming reservation requests before we can set up your dedicated test environment.
Validate credentials
Your endpoint must validate the wsse:UsernameToken on every incoming request. If the credentials do not match, return the following error response:
Code 497 — Return this error when the wsse:Username and wsse:Password in the incoming request do not match your configured credentials.
Validate hotel code
Your endpoint must verify that the HotelCode in the request matches a property configured in your system. If not found, return the following error response:
Code 392 — Return this error when the HotelCode in the incoming request does not match any property configured in your system.
You're ready for the next step. Once your endpoint handles the scenarios above, contact the Partner Integrations team with your endpoint URL, credentials, and hotel code. We'll set up your dedicated test account to continue development.
Explore with Postman
SiteMinder's SMX Postman workspace contains collections and environments to help you build, test, and validate your integration for certification. Fork the collections and environments to your own Postman account to get started.
For full certification scenario coverage, see Testing and Certification.
Still have questions?
Use the Ask button at the top of the page to chat with our AI assistant — it can help you navigate the guide, understand requirements, and troubleshoot issues.
If you need more support, visit Integration Support.
Last updated
Was this helpful?