---
title: "Add an attendee to a booking"
method: POST
path: "/v2/bookings/{bookingUid}/attendees"
tags: ["Bookings / Attendees"]
---

# Add an attendee to a booking

`POST /v2/bookings/{bookingUid}/attendees`

Add a new attendee to an existing booking by its UID.

      **Side effects:**
      - The booking's attendee list is updated in the database
      - The calendar event is updated on connected calendars (Google Calendar, Outlook, etc.) to include the new attendee
      - An email notification is sent to the new attendee with the booking details

      **Permissions:**
      - The authenticated user must be either the booking organizer, an existing attendee, or have the `booking.update` permission for the team

      <Note>The cal-api-version header is required for this endpoint. Without it, the request will fail with a 404 error.</Note>

## Path parameters

- `bookingUid` string, required

## Headers

- `cal-api-version` string, required
- `Authorization` string, required

## Request body

- AddAttendeeInput20240813
  - `name` string, required — The name of the attendee.
  - `timeZone` string, required — The time zone of the attendee.
  - `phoneNumber` string — The phone number of the attendee in international format.
  - `language` 'ar' | 'ca' | 'de' | 'es' | 'eu' | 'he' | 'id' | 'ja' | 'lv' | 'pl' | 'ro' | 'sr' | 'th' | 'vi' | 'az' | 'cs' | 'el' | 'es-419' | 'fi' | 'hr' | 'it' | 'km' | 'nl' | 'pt' | 'ru' | 'sv' | 'tr' | 'zh-CN' | 'bg' | 'da' | 'en' | 'et' | 'fr' | 'hu' | 'iw' | 'ko' | 'no' | 'pt-BR' | 'sk' | 'ta' | 'uk' | 'zh-TW' | 'bn' — The preferred language of the attendee. Used for booking confirmation.
  - `email` string, required — The email of the attendee.

## Response `201`

- AddAttendeeOutput20240813
  - `status` 'success' | 'error', required
  - `data` BookingAttendeeOutput20240813, required
    - `name` string, required
    - `email` string, required
    - `displayEmail` string, required — Clean email for display purposes
    - `timeZone` string, required
    - `language` 'ar' | 'ca' | 'de' | 'es' | 'eu' | 'he' | 'id' | 'ja' | 'lv' | 'pl' | 'ro' | 'sr' | 'th' | 'vi' | 'az' | 'cs' | 'el' | 'es-419' | 'fi' | 'hr' | 'it' | 'km' | 'nl' | 'pt' | 'ru' | 'sv' | 'tr' | 'zh-CN' | 'bg' | 'da' | 'en' | 'et' | 'fr' | 'hu' | 'iw' | 'ko' | 'no' | 'pt-BR' | 'sk' | 'ta' | 'uk' | 'zh-TW' | 'bn'
    - `absent` boolean, required
    - `phoneNumber` string
    - `id` number, required
    - `bookingId` number, required

---

[API](https://skmtc.net/calcom/apis/cal-diy-api-v2.md) · [All operations](https://skmtc.net/calcom/apis/cal-diy-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/calcom/cal-diy-api-v2/versions/16de9d3eb7b3/schema)