Quick Start

Get from zero to a working API call in under five minutes.

  1. Get your Client UUID

    Contact the Maison team or locate your Client UUID in the business console. Every API request that targets a specific property requires this identifier.

  2. Get an API Key

    Sign in, then call PUT /api/user/apikey to create a key. You must supply a valid session cookie or Bearer token.

    bash
    curl -X PUT https://maison-labs.com/api/user/apikey \
  -H "Cookie: session=YOUR_TOKEN" \
  -H "Content-Type: application/json"

    The full key is shown once and cannot be recovered. Store it securely before closing the response.

  3. Make your first request

    Verify your key is active by calling the auth check endpoint:

    bash
    curl https://maison-labs.com/auth/ \
  -H "x-api-key: mx_p_YOUR_KEY"

    A 200 OK response confirms the key is valid and your identity is resolved.

  4. Send a message

    POST a query to the concierge. Include your Client UUID so the API knows which property context to use.

    bash
    curl -X POST https://maison-labs.com/api/message \
  -H "x-api-key: mx_p_YOUR_KEY" \
  -H "x-client-id: YOUR_CLIENT_UUID" \
  -H "Content-Type: application/json" \
  -d '{"query": "What time is checkout?"}'

  5. Explore further

    • API Reference — interactive playground for every endpoint
    • A2A Protocol — agent-to-agent JSON-RPC 2.0 interface
    • MCP Integration — use Maison as a tool provider in Claude Desktop, VS Code, and other LLM clients
    • Integration Guides — embed the chat widget in HTML, React, Next.js, WordPress, Shopify, and more