---
title: "Confirm a booking"
method: PUT
path: "/v3/scheduling/bookings/{booking_id}"
tags: ["Bookings"]
---

# Confirm a booking

`PUT /v3/scheduling/bookings/{booking_id}`

Confirms or cancels the specified pending booking. Nylas also updates the associated event on the
provider.

Nylas validates the provided session ID and uses it to retrieve the related
[Configuration object](/docs/reference/api/configurations/). If you created a public
Configuration, you don't need to include the `Authorization` request header with a session ID, but
you do need to pass the Configuration object ID as a query parameter.

When you make a `PUT` request, Nylas replaces all data in the nested object with the information
included in your request. For more information, see
[Updating objects](/docs/reference/api/#updating-objects).

## Request body

- BookingConfirm
  - `salt` string, required — The salt extracted from the booking reference embedded in the organizer confirmation link, encoded as a URL-safe base64 string (without padding).
  - `status` 'confirmed' | 'cancelled', required — The action to take on the pending booking.
  - `cancellation_reason` string — The reason that the booking is being cancelled.

## Response `200`

Booking confirmed or cancelled

- union
  - object — Returned when the booking was confirmed.
    - `request_id` string — The ID of the request.
    - `data` object
      - `booking_id` string — The unique ID of the booking.
      - `description` string — A brief description of the event.
      - `event_id` string — The event ID associated with the booking.
      - `organizer` object — The participant designated as the organizer of the event.
        - `email` string — The organizer's email address.
        - `name` string — The organizer's name.
      - `status` 'booked' | 'cancelled' | 'pending' — The status of the booking.
      - `title` string — The title of the event.
  - object — Returned when the booking was cancelled.
    - `request_id` string, required — The ID of the request.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `429` — Rate Limit
- `504` — Provider Failure

---

[API](https://skmtc.dev/nylas/apis/nylas-api.md) · [All operations](https://skmtc.dev/nylas/apis/nylas-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nylas/nylas-api/revisions/51c2c1b4ecff/schema)