# Add guests

`POST /onair.guest.add`

## Description

Adds one or more guests to an On-Air event.

**Access:** Organization and Personal.

**Required scope:** `onair:write`

---

**OpenAPI Spec:** [onair.json](https://developer.ro.am/onair.json)

## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Request Body

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `eventId` | string | Yes | Identifier of the event to add guests to. |
| `guests` | object[] | Yes | List of guests to add. |

**guests** (array item):

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `email` | string | Yes | Email address of the guest. |
| `name` | string | No | Display name of the guest. |
| `phone` | string | No | Phone number of the guest. |
| `status` | "invited" | "going" | "maybe" | "notGoing" | No | Initial RSVP status. Defaults to `invited` if omitted. |

### Example Request

```json
{
  "eventId": "evt_abc123",
  "guests": [
    {
      "email": "alice@example.com",
      "name": "Alice Johnson",
      "status": "going"
    },
    {
      "email": "bob@example.com",
      "name": "Bob Williams"
    }
  ]
}
```

## Responses

### 200 - The added guests.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `guests` | OnAirGuest[] | No |  |

**OnAirGuest** (array item):

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the guest. |
| `eventId` | string | Yes | Identifier of the event this guest belongs to. |
| `email` | string | No | Email address of the guest. |
| `name` | string | No | Display name of the guest. |
| `phone` | string | No | Phone number of the guest. |
| `status` | "invited" | "going" | "maybe" | "notGoing" | Yes | RSVP status of the guest. |
| `created` | string | No | When the guest was added (RFC 3339). |
| `updated` | string | No | When the guest record was last updated (RFC 3339). |

### 400 - Bad request.

### 401 - Presented invalid authentication credentials.

### 500 - An internal error occurred.

---

*Machine-readable API documentation.*
*Full documentation: https://developer.ro.am/docs/onair-api/onair-guest-add*