# Meeting started

**Event:** `meeting.started`

## Description

Fires when a meeting starts. Personal destinations only receive meetings
the authorizing user participated in. Organization destinations are
roam-wide only with [`admin:meetings:read`](/docs/guides/scopes#meeting-width-adminmeetingsread);
otherwise the install's bot must have access to the meeting.

**Event name:** `meeting.started`

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`.

**Required scope:** `meetings:read` (`user:read` to include `host`,
`user:read.email` for the host's email).

## Webhook Payload


### Example Payload

```json
{
  "type": "meeting.started",
  "eventId": "0197f9a4-3c73-7cc3-ad4e-5f6a7b8c9d0e",
  "timestamp": "2026-04-21T17:00:02.000000Z",
  "apiVersion": "2026-07-07",
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "title": "Weekly Team Standup",
    "start": "2026-04-21T17:00:00Z",
    "host": {
      "type": "member",
      "id": "709b8a57-70bc-427a-b6f0-b16ba5297f8c",
      "name": "Alex Chen",
      "email": "alex.chen@example.com"
    }
  }
}
```

---

*Machine-readable API documentation.*
*Full documentation: https://developer.ro.am/docs/webhooks/meeting-started*