---
title: "Update a lead booking"
method: PATCH
path: "/api/v1/lead_bookings/{lead_booking_id}"
tags: ["Leads"]
---

# Update a lead booking

`PATCH /api/v1/lead_bookings/{lead_booking_id}`

## Request

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

Updates the package, schedule, length, or requested staff member of an existing lead booking. Only the fields included in the request are changed; send `staff_id` as an empty string to clear the staff request.

**Required permission:** `lead_write`

## Path parameters

- `lead_booking_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. Send an empty string to clear it.

## Response `200`

lead booking updated

---

[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)