# Create media processor

**POST /v1/MediaProcessors**


A MediaProcessor resource provides the ability to capture content from a web application with a Twilio Media Extension to create a livestream.

## Servers



## Parameters



### Body:  (object)

- **MaxDuration** (integer)
  The maximum time, in seconds, that the MediaProcessor can run 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 MediaProcessor, regardless of whether media is still streaming.
- **StatusCallback** (string(uri))
  The URL to which Twilio will send asynchronous webhook requests for every MediaProcessor event. See [Status Callbacks](/docs/live/status-callbacks) for details.
- **Extension** (string)
  The [Media Extension](/docs/live/api/media-extensions-overview) name or URL. Ex: `video-composer-v1`
- **ExtensionContext** (string)
  The context of the Media Extension, represented as a JSON dictionary. See the documentation for the specific [Media Extension](/docs/live/api/media-extensions-overview) you are using for more information about the context to send.
- **ExtensionEnvironment** ()
  User-defined environment variables for the Media Extension, represented as a JSON dictionary of key/value strings. See the documentation for the specific [Media Extension](/docs/live/api/media-extensions-overview) you are using for more information about whether you need to provide this.
- **StatusCallbackMethod** (string(http-method))
  The HTTP method Twilio should use to call the `status_callback` URL. Can be `POST` or `GET` and the default is `POST`.


## Responses
### 201
Created

#### Body:  (object)
- **account_sid** (string | null)
  The SID of the Account that created the resource
- **date_created** (string(date-time) | null)
  The ISO 8601 date and time in GMT when the resource was created
- **date_updated** (string(date-time) | null)
  The ISO 8601 date and time in GMT when the resource was last updated
- **ended_reason** (string | null)
  The reason why a MediaProcessor ended
- **extension** (string | null)
  The Media Extension name or URL
- **extension_context** (string | null)
  The Media Extension context
- **max_duration** (integer | null)
  Maximum MediaProcessor duration in seconds
- **sid** (string | null)
  The unique string that identifies the resource
- **status** (string | null)
  The status of the MediaProcessor
- **status_callback** (string(uri) | null)
  The URL to which Twilio will send MediaProcessor event updates
- **status_callback_method** (string(http-method) | null)
  The HTTP method Twilio should use to call the `status_callback` URL
- **url** (string(uri) | null)
  The absolute URL of the resource


[Powered by Bump.sh](https://bump.sh)