# On-Air event created

**Event:** `onair.event.created`

## Description

A new On-Air event was created.

**Event name:** `onair.event.created`

**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 every On-Air event.

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

## Webhook Payload


### Example Payload

```json
{
  "type": "onair.event.created",
  "eventId": "0197f9a7-6fa6-7aa6-907b-8c9d0e1f2a3b",
  "timestamp": "2026-06-15T09:30:00.000000Z",
  "apiVersion": "2026-07-07",
  "data": {
    "id": "9f1c2d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
    "title": "Product Launch",
    "slug": "product-launch",
    "start": "2026-07-01T17:00:00Z",
    "end": "2026-07-01T18:00:00Z",
    "timeZone": "America/Los_Angeles",
    "eventPageUrl": "https://ro.am/onair/product-launch",
    "enableSEO": true,
    "autoAdmit": false,
    "disableRSVP": false,
    "hosts": [
      {
        "id": "709b8a57-70bc-427a-b6f0-b16ba5297f8c",
        "name": "Alex Chen"
      }
    ]
  }
}
```

---

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