# Magicast created

**Event:** `magicast.created`

## Description

A Magicast has been created.

**Event name:** `magicast.created`

The payload is metadata only. It does **not** include transcript `cues` or
a signed `videoUrl` (those expire / can be large). Use the `id` with
[`/magicast.info`](/docs/api/magicast-info) for cues, chapters, and video.
If `videoStatus` is `processing`, the player share link can still be minted
with [`/magicast.shareLink`](/docs/api/magicast-share-link).

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:** `magicast:read`

## Webhook Payload


### Example Payload

```json
{
  "type": "magicast.created",
  "eventId": "0197f9a3-2b62-7bb2-9c3d-4e5f6a7b8c9d",
  "timestamp": "2025-03-15T10:30:00.000000Z",
  "apiVersion": "2026-07-07",
  "data": {
    "id": "d4e5f6a7-b8c9-0123-4567-89abcdef0123",
    "name": "Weekly Standup Recording",
    "createdAt": "2025-03-15T10:30:00Z",
    "ownerId": "709b8a57-70bc-427a-b6f0-b16ba5297f8c",
    "coverImageUrl": "https://ro.am/magicast-covers/d4e5f6a7-b8c9-0123-4567-89abcdef0123",
    "durationMs": 184000,
    "videoStatus": "available",
    "hasTranscript": true,
    "chapters": [
      {
        "title": "Updates",
        "startTime": 0
      }
    ]
  }
}
```

---

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