---
title: "POST /v1/PlayerStreamers"
method: POST
path: "/v1/PlayerStreamers"
---

# POST /v1/PlayerStreamers

`POST /v1/PlayerStreamers`

## Response `201`

Created

- MediaV1PlayerStreamer
  - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the PlayerStreamer resource.
  - `date_created` string, date-time, nullable — The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `date_updated` string, date-time, nullable — The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `ended_reason` 'ended-via-api' | 'max-duration-exceeded' | 'stream-disconnected-by-source' | 'unexpected-failure'
  - `links` object, nullable — The URLs of related resources.
  - `max_duration` integer, nullable — The maximum time, in seconds, that the PlayerStreamer is active (`created` or `started`) before automatically ends. The default value is 300 seconds, and the maximum value is 90000 seconds. Once this maximum duration is reached, Twilio will end the PlayerStreamer, regardless of whether media is still streaming.
  - `sid` string, nullable — The unique string generated to identify the PlayerStreamer resource.
  - `status` 'created' | 'started' | 'ended' | 'failed'
  - `status_callback` string, uri, nullable — The URL to which Twilio will send asynchronous webhook requests for every PlayerStreamer event. See [Status Callbacks](/docs/live/status-callbacks) for more details.
  - `status_callback_method` 'HEAD' | 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE', http-method, nullable — The HTTP method Twilio should use to call the `status_callback` URL. Can be `POST` or `GET` and the default is `POST`.
  - `url` string, uri, nullable — The absolute URL of the resource.
  - `video` boolean, nullable — Specifies whether the PlayerStreamer is configured to stream video. Defaults to `true`.

---

[API](https://skmtc.net/twilio/apis/twilio-media-v1.md) · [All operations](https://skmtc.net/twilio/apis/twilio-media-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/twilio-media-v1/versions/788b703c934f/schema)