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

# Add guests

> Add one or more guests to a Luma event by email or user ID with luma.events.guests.add(), with optional approval and invite controls.

<Badge color="purple">SDK</Badge> `luma.events.guests.add(eventId: string, body: GuestAddParams): Promise<void>`

Adds one or more guests to an event.

<RequestExample>
  ```typescript Example theme={null}
  await luma.events.guests.add("evt-abc123", {
    guests: [
      { email: "jane@example.com", name: "Jane Doe" },
      { email: "john@example.com", name: "John Doe" },
    ],
  });
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  null
  ```
</ResponseExample>

### Parameters

<ParamField path="eventId" type="string" required>
  Event `api_id` from `events.list()`.
</ParamField>

<ParamField path="body" type="GuestAddParams" required>
  Guest details to add. See the [official Luma API docs](https://docs.luma.com) for available fields.
</ParamField>

### Test it

Add a test guest to a test event, then confirm with `events.guests.list()`:

```typescript theme={null}
const eventId = "evt-abc123";

await luma.events.guests.add(eventId, {
  guests: [{ email: "test@example.com", name: "Test Guest" }],
});
console.log("Guest added");
```