---
title: "Create Media Session"
method: POST
path: "/api/v1/media/sessions"
tags: ["ACS Media Session", "WebSocket"]
---

# Create Media Session

`POST /api/v1/media/sessions`

Create a new media streaming session for Azure Communication Services.

Initializes a media session with specified audio configuration and returns
WebSocket connection details for real-time audio streaming. This endpoint
prepares the infrastructure for bidirectional media communication with
configurable audio parameters.

Args:
    request: Media session configuration including call connection ID, 
            audio format, sample rate, and streaming options.

Returns:
    MediaSessionResponse: Session details containing unique session ID,
    WebSocket URL for streaming, status, and audio configuration.

Raises:
    HTTPException: When session creation fails due to invalid configuration
                  or system resource constraints.

Example:
    >>> request = MediaSessionRequest(call_connection_id="call_123")
    >>> response = await create_media_session(request)
    >>> print(response.websocket_url)

## Request body

- MediaSessionRequest — Request schema for starting a media session.
  - `call_connection_id` string, required — ACS call connection identifier
  - `sample_rate` integer, nullable — Audio sample rate in Hz
  - `channels` integer, nullable — Number of audio channels
  - `audio_format` string, nullable — Audio format (pcm_16, pcm_24, opus, etc.)
  - `chunk_size` integer, nullable — Audio chunk size in bytes
  - `enable_transcription` boolean, nullable — Enable real-time transcription
  - `enable_vad` boolean, nullable — Enable voice activity detection

## Response `200`

Successful Response

- MediaSessionResponse — Response schema for media session creation.
  - `session_id` string, required — Unique media session identifier
  - `websocket_url` string, required — WebSocket URL for audio streaming
  - `status` string, required — Session status
  - `created_at` string, required — Session creation timestamp
  - `configuration` object, required — Session configuration settings

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/azure/apis/real-time-voice-agent-api.md) · [All operations](https://skmtc.net/azure/apis/real-time-voice-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/real-time-voice-agent-api/revisions/3e24c76dccd5/schema)