---
title: "Create a new Session"
method: POST
path: "/v1/Services/{ServiceSid}/Sessions"
tags: ["ProxyV1Session"]
---

# Create a new Session

`POST /v1/Services/{ServiceSid}/Sessions`

Create a new Session

## Path parameters

- `ServiceSid` string, required

## Response `201`

Created

- ProxyV1ServiceSession
  - `sid` string, nullable — The unique string that we created to identify the Session resource.
  - `service_sid` string, nullable — The SID of the [Service](https://www.twilio.com/docs/proxy/api/service) the session is associated with.
  - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Session resource.
  - `date_started` string, date-time, nullable — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date when the Session started.
  - `date_ended` string, date-time, nullable — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date when the Session ended.
  - `date_last_interaction` string, date-time, nullable — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date when the Session last had an interaction.
  - `date_expiry` string, date-time, nullable — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date when the Session should expire. If this is value is present, it overrides the `ttl` value.
  - `unique_name` string, nullable — An application-defined string that uniquely identifies the resource. This value must be 191 characters or fewer in length and be unique. Supports UTF-8 characters. **This value should not have PII.**
  - `status` 'open' | 'in-progress' | 'closed' | 'failed' | 'unknown' — The status of the Session. Can be: `open`, `in-progress`, `closed`, `failed`, or `unknown`.
  - `closed_reason` string, nullable — The reason the Session ended.
  - `ttl` integer — The time, in seconds, when the session will expire. The time is measured from the last Session create or the Session's last Interaction.
  - `mode` 'message-only' | 'voice-only' | 'voice-and-message' — The Mode of the Session. Can be: `message-only`, `voice-only`, or `voice-and-message`.
  - `date_created` string, date-time, nullable — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was created.
  - `date_updated` string, date-time, nullable — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was last updated.
  - `url` string, uri, nullable — The absolute URL of the Session resource.
  - `links` object, nullable — The URLs of resources related to the Session.

## Changes

- **2025-07-03** (v1) `541bd9c51dad` — 1 info
  - the `Participants/items/` request property type/format was generalized from `object`/`` to ``/``
- **2025-03-11** (v1) `43b8bd752042` — 1 breaking
  - the `Participants/items/` request property type/format changed from ``/`` to `object`/``
- **2024-08-26** (v1) `5d96b79babfd` — 1 info
  - the `ttl` response's property default value `0` was added for the status `201`
- **2023-08-10** (v1) `6b9a26829560` — 1 info
  - api tag `ProxyV1Session` added

[Change history](https://skmtc.dev/twilio/apis/proxy-v1/changes/v1/Services/:ServiceSid/Sessions/post.md)

---

[API](https://skmtc.dev/twilio/apis/proxy-v1.md) · [All operations](https://skmtc.dev/twilio/apis/proxy-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/twilio/proxy-v1/revisions/a2e6d27b3ecd/schema)