# On-Air guests added

**Event:** `onair.guest.added`

## Description

One or more guests were added to an On-Air event.

**Event name:** `onair.guest.added`

**Required scope:** `onair:read`

Delivered inside the standard [event envelope](/docs/webhooks/webhooks#event-envelope);
the schema below shows the full delivery body with this event's payload
under `data`.

**Filter** on [`webhook.subscribe`](/docs/webhooks/webhook-subscribe).
Omit `filter` to receive guest additions for every On-Air event.

```json
{
  "url": "https://example.com/hooks/onair",
  "event": "onair.guest.added",
  "filter": { "eventId": "9f1c2d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f" }
}
```

## Webhook Payload


### Example Payload

```json
{
  "type": "onair.guest.added",
  "eventId": "0197f9ab-a3ea-7eea-94bf-2a3b4c5d6f70",
  "timestamp": "2026-06-16T10:15:00.000000Z",
  "apiVersion": "2026-07-07",
  "data": {
    "event": {
      "id": "9f1c2d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
      "title": "Product Launch"
    },
    "guests": [
      {
        "id": "af6663d5-0f37-4105-95df-4fea20ef7c7c",
        "email": "jordan@example.com",
        "name": "Jordan Smith",
        "status": "invited"
      }
    ]
  }
}
```

---

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