# Create a new Stream.

**POST /v1/Services/{ServiceSid}/Streams**

Create a new Stream.


## Servers
- https://sync.twilio.com: https://sync.twilio.com ()


## Authentication methods
- Account sid auth token


## Parameters

### Path parameters
- **ServiceSid** (string)
  The SID of the [Sync Service](https://www.twilio.com/docs/sync/api/service) to create the new Stream in.


### Body: application/x-www-form-urlencoded (object)

- **UniqueName** (string)
  An application-defined string that uniquely identifies the resource. This value must be unique within its Service and it can be up to 320 characters long. The `unique_name` value can be used as an alternative to the `sid` in the URL path to address the resource.
- **Ttl** (integer)
  How long, [in seconds](https://www.twilio.com/docs/sync/limits#sync-payload-limits), before the Stream expires and is deleted (time-to-live).


## Responses
### 201
Created
#### Headers
- **Access-Control-Allow-Origin** (string)
  Specify the origin(s) allowed to access the resource
- **Access-Control-Allow-Methods** (string)
  Specify the HTTP methods allowed when accessing the resource
- **Access-Control-Allow-Headers** (string)
  Specify the headers allowed when accessing the resource
- **Access-Control-Allow-Credentials** (boolean)
  Indicates whether the browser should include credentials
- **Access-Control-Expose-Headers** (string)
  Headers exposed to the client

#### Body: application/json (object)
- **sid** (string | null)
  The unique string that we created to identify the Sync Stream resource.
- **unique_name** (string | null)
  An application-defined string that uniquely identifies the resource. It can be used in place of the resource's `sid` in the URL to address the resource.
- **account_sid** (string | null)
  The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Sync Stream resource.
- **service_sid** (string | null)
  The SID of the [Sync Service](https://www.twilio.com/docs/sync/api/service) the resource is associated with.
- **url** (string(uri) | null)
  The absolute URL of the Message Stream resource.
- **links** (object(uri-map) | null)
  The URLs of the Stream's nested resources.
- **date_expires** (string(date-time) | null)
  The date and time in GMT when the Message Stream expires and will be deleted, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. If the Message Stream does not expire, this value is `null`. The Stream might not be deleted immediately after it expires.
- **date_created** (string(date-time) | null)
  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) | null)
  The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
- **created_by** (string | null)
  The identity of the Stream's creator. If the Stream is created from the client SDK, the value matches the Access Token's `identity` field. If the Stream was created from the REST API, the value is 'system'.


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