---
title: "Generate a BluePillow booking deep link for a chosen property"
method: POST
path: "/bookings/initiate"
tags: ["handoff"]
---

# Generate a BluePillow booking deep link for a chosen property

`POST /bookings/initiate`

## Request

- Base URL: `https://api.b2a.bluepillow.com/v1`
- URL: `https://api.b2a.bluepillow.com/v1/bookings/initiate`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string, uuid, required
- `B2A-Version` string, date

## Request body

- InitiateRequest
  - `property_id` string, required
  - `dates` StayDates, required
    - `check_in` string, date, required
    - `check_out` string, date, required
  - `guests` Guests, required
    - `adults` integer, required
    - `children_ages` integer[]
    - `rooms` integer
  - `ota` string, nullable

## Response `200`

Tracking id plus booking deep link

- InitiateResult
  - `tracking_id` string, required
  - `deep_link` string, required
  - `ota` string, nullable

## Other responses

- `400`: Invalid request
- `401`: Auth missing or invalid
- `404`: Property not found
- `429`: Rate limited

---

[API](https://skmtc.dev/bluepillow/apis/b2a-api.md) · [All operations](https://skmtc.dev/bluepillow/apis/b2a-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bluepillow/apis/b2a-api/revisions/1dfd82be92b6?raw)