# Transcript started

**Event:** `transcript.started`

## Description

Magic Minutes has started on a meeting and a live transcript is now available.

**Event name:** `transcript:started`

Use the transcript `id` from this payload with
[`/transcript.info`](/docs/chat-api/get-transcript) to fetch live transcript
content. Pass the `sinceOffset` parameter to poll for incremental updates.

**Required scope:** `transcript:read`

The `hostEmail` field is only included if your app has the `user:read.email` scope.

## Webhook Payload

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | string | No | The transcript ID. Use with `/transcript.info` to fetch transcript content. |
| `meetingId` | string | No | The meeting GUID. |
| `start` | string | No | When Magic Minutes began. |
| `location` | string | No | The meeting location or name. |
| `hostEmail` | string | No | Email of the meeting host. Only included if your app has the `user:read.email` scope. |

### Example Payload

```json
{
  "id": "f9274881-c48f-4838-865d-98140ea7016d",
  "meetingId": "dde68f39-3eb0-42ef-9873-511509c8764f",
  "start": "2026-03-17T14:00:00.000Z",
  "location": "Conference Room A",
  "hostEmail": "alex.chen@example.com"
}
```

---

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