> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Add booking attendee

> Adds one attendee to an existing booking.

`calcom.addBookingAttendee` adds one attendee to an existing booking.

```ts automations/add-booking-attendee.automation.ts theme={null}
import { automation, markSignificant } from "automate.ax"
import { calcom } from "automate.ax/calcom"

export default automation("Add booking attendee", () => {
  markSignificant(
    calcom.addBookingAttendee({
      bookingUid: "booking-uid",
      name: "Grace Hopper",
      email: "grace@example.com",
      timeZone: "America/New_York",
    }),
  )
})
```

## Input

Pass these fields:

| Field         | Type             | Required | Description                                                                             |
| ------------- | ---------------- | -------- | --------------------------------------------------------------------------------------- |
| `bookingUid`  | `string`         | Yes      | —                                                                                       |
| `name`        | `string`         | Yes      | The name of the attendee.                                                               |
| `timeZone`    | `string`         | Yes      | The time zone of the attendee.                                                          |
| `phoneNumber` | `string`         | No       | The phone number of the attendee in international format.                               |
| `language`    | `string enum`    | No       | The preferred language of the attendee. Used for booking confirmation. Default: `"en"`. |
| `email`       | `string (email)` | Yes      | The email of the attendee.                                                              |

## Output

Returns an object with these fields:

| Field          | Type          | Required | Description                      |
| -------------- | ------------- | -------- | -------------------------------- |
| `name`         | `string`      | Yes      | —                                |
| `email`        | `string`      | Yes      | —                                |
| `displayEmail` | `string`      | Yes      | Clean email for display purposes |
| `timeZone`     | `string`      | Yes      | —                                |
| `language`     | `string enum` | No       | —                                |
| `absent`       | `boolean`     | Yes      | —                                |
| `phoneNumber`  | `string`      | No       | —                                |
| `id`           | `number`      | Yes      | —                                |
| `bookingId`    | `number`      | Yes      | —                                |

Cal.com enforces account role, plan, and availability requirements. Provider rejections surface as structured action failures with the HTTP status and any `Retry-After` delay.
