Create Event

Create a new event for the authenticated user

Info

Required scope: stream.write

Warning

This method requires authentication

Create an event that the user can stream to later. The created event has no destinations attached — use Add Event Destination to attach the channels you want to broadcast to.

curl -X POST \
     -H "Authorization: Bearer [access token]" \
     -H "Content-Type: application/json" \
     -d '{"streamType": "encoder", "title": "My weekly show", "description": "Episode 12", "scheduledFor": "2026-05-10T15:00:00Z"}' \
     https://api.restream.io/v2/user/events/new

Request Body

FieldTypeDescription
streamTypestring"studio" or "encoder" (required). See below.
titlestringEvent title (optional).
descriptionstringEvent description (optional).
scheduledForstringWhen the event is scheduled to start, ISO 8601 date-time (optional).

streamType:

ValueDescription
studioEvent will be streamed from Restream Studio.
encoderEvent will be streamed from a third-party encoder.

Response

Success (201)
Error (Title Too Long)
Error (Insufficient Scope)
{
  "id": "2527849f-f961-4b1d-8ae0-8eae4f068327"
}