Getting Started with Xeni Quick Builder

Xeni Quick Builder is a whitelabel booking engine that lets you offer hotel search and booking capabilities directly within your platform. Unlike the standalone Xeni APIs, Quick Builder provides a fully rendered booking interface that you embed using SSO-based authentication.

What Is Quick Builder?

Quick Builder is a hosted booking experience powered by Xeni. Your users authenticate through your platform, and a secure SSO redirect logs them into the Xeni whitelabel environment. From there, they can search for hotels, view results, and complete bookings — all within a branded experience that matches your platform.

How SSO Authentication Works

Quick Builder uses JWT (JSON Web Token) based Single Sign-On instead of the Auth V2 signature-based authentication used by the Xeni APIs. The flow works as follows:

1. User logs into your platform — Your application authenticates the user through your own login system.
2. Your server generates a JWT — When the user is ready to access the booking engine, your backend creates a signed JWT containing the user's identity claims.
3. Redirect to Xeni — Your application redirects the user to the Xeni SSO URL with the JWT token and a destination path.
4. Xeni validates the token — Xeni calls your JWT Validation Endpoint to verify the token is authentic and not expired.
5. User accesses Quick Builder — Once validated, the user is logged into the whitelabel booking engine and can search and book hotels.

SSO Redirect URL Format

The redirect URL follows this structure:

https://your-xeni-domain.com/sso?token={JWTTOKEN}&navigateTo={ENCODEDDESTINATION}

Integration Checklist

To complete your Quick Builder integration, you will need to:

Key Differences from Xeni APIs

Next Steps

Start by setting up SSO authentication. This is the foundation of your Quick Builder integration and must be completed before any other configuration.