> ## 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 guests

> Adds guest email addresses to an existing booking.

`calcom.addBookingGuests` adds guest email addresses to an existing booking.

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

export default automation("Add booking guests", () => {
  markSignificant(
    calcom.addBookingGuests({
      bookingUid: "booking-uid",
      guests: [{ email: "guest@example.com" }],
    }),
  )
})
```

## Input

Pass these fields:

| Field        | Type       | Required | Description                                                                              |
| ------------ | ---------- | -------- | ---------------------------------------------------------------------------------------- |
| `bookingUid` | `string`   | Yes      | —                                                                                        |
| `guests`     | `object[]` | Yes      | Array of guests to add to the booking. Maximum 100 guests per request. Minimum items: 1. |

## Output

The action removes the outer Cal.com status envelope. Its result is one of these data variants:

| Variant                  | Result                                                   |
| ------------------------ | -------------------------------------------------------- |
| Regular booking          | One booking object.                                      |
| Recurring booking        | One recurring booking object or an array of them.        |
| Seated booking           | One seated booking object.                               |
| Recurring seated booking | One recurring seated booking object or an array of them. |

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.