---
title: "Add a booking to a lead"
method: POST
path: "/api/v1/leads/{lead_id}/lead_bookings"
tags: ["Leads"]
---

# Add a booking to a lead

`POST /api/v1/leads/{lead_id}/lead_bookings`

## Request

- Base URL: `https://api.checkcherry.com`
- URL: `https://api.checkcherry.com/api/v1/leads/{lead_id}/lead_bookings`
- Auth: none declared. Required headers: `Api-Key`

Adds a new booking (package selection) to an existing lead. Staff is requested per package, so each booking carries its own `staff_id`.

**Required permission:** `lead_write`

## Path parameters

- `lead_id` integer, required

## Headers

- `Api-Key` string, required

## Request body

- object
  - `event_type_id` integer: Package (event type) ID. Must belong to this business.
  - `event_category_id` integer: Service (event category) ID. Ignored when `event_type_id` is sent: the package sets the service.
  - `package_group_id` integer: Package group ID. Ignored when `event_type_id` is sent: the package sets the group.
  - `starts_at_date` string: Event date (e.g. 2026-09-15)
  - `starts_at_time` string: Event start time (e.g. 06:00 PM)
  - `length_in_minutes` integer: Length in minutes (for time-based packages)
  - `length_in_days` integer: Length in days (for multi-day packages)
  - `units` integer: Number of units (for per-unit packages)
  - `package_unit_range_id` integer: Selected package unit range ID
  - `staff_id` integer: Staff member requested for this package

## Response `200`

lead booking created

---

[API](https://skmtc.dev/checkcherry/apis/check-cherry-business-api.md) · [All operations](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/revisions/84a9aabdf519?raw)