---
title: "Request siprec session for a call"
method: POST
path: "/texml/Accounts/{account_sid}/Calls/{call_sid}/Siprec.json"
tags: ["TeXML REST Commands"]
---

# Request siprec session for a call

`POST /texml/Accounts/{account_sid}/Calls/{call_sid}/Siprec.json`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/texml/Accounts/{account_sid}/Calls/{call_sid}/Siprec.json`
- Auth: HTTP bearer

Starts siprec session with specified parameters for call idientified by call_sid.

## Path parameters

- `account_sid` string, required
- `call_sid` string, required

## Request body `application/x-www-form-urlencoded`

- TexmlCreateSiprecSessionRequestBody
  - `ConnectorName` string: The name of the connector to use for the SIPREC session.
  - `Name` string: Name of the SIPREC session. May be used to stop the SIPREC session from TeXML instruction.
  - `Track` 'both_tracks' | 'inbound_track' | 'outbound_track': The track to be used for siprec session. Can be `both_tracks`, `inbound_track` or `outbound_track`. Defaults to `both_tracks`.
  - `IncludeMetadataCustomHeaders` true | false: When set, custom parameters will be added as metadata (recording.session.ExtensionParameters). Otherwise, they’ll be added to sip headers.
  - `Secure` true | false: Controls whether to encrypt media sent to your SRS using SRTP and TLS. When set you need to configure SRS port in your connector to 5061.
  - `SessionTimeoutSecs` integer: Sets `Session-Expires` header to the INVITE. A reinvite is sent every half the value set. Usefull for session keep alive. Minimum value is 90, set to 0 to disable.
  - `SipTransport` 'udp' | 'tcp' | 'tls': Specifies SIP transport protocol.
  - `StatusCallback` string: URL destination for Telnyx to send status callback events to for the siprec session.
  - `StatusCallbackMethod` 'GET' | 'POST': HTTP request type used for `StatusCallback`.

## Response `200`

Successful SIPREC session create response

- TexmlCreateSiprecSessionResponseBody
  - `account_sid` string: The id of the account the resource belongs to.
  - `call_sid` string: The id of the call the resource belongs to.
  - `sid` string: The SID of the siprec session.
  - `date_created` string: The date and time the siprec session was created.
  - `date_updated` string: The date and time the siprec session was last updated.
  - `start_time` string: The date and time the siprec session was started.
  - `status` 'in-progress' | 'stopped': The status of the siprec session.
  - `track` 'both_tracks' | 'inbound_track' | 'outbound_track': The track used for the siprec session.
  - `uri` string: The URI of the siprec session.
  - `error_code` string: The error code of the siprec session.

## Other responses

- `404`: Resource not found

## Changes

> 152 revisions in range; 1 not diffed.

- **2026-09-16** `a6a61a29ecdd`: 4 breaking, 5 info
  - removed the enum value `false` of the request property `IncludeMetadataCustomHeaders`
  - removed the enum value `false` of the request property `Secure`
  - removed the enum value `true` of the request property `IncludeMetadataCustomHeaders`
  - removed the enum value `true` of the request property `Secure`
  - …5 more
- **2026-08-17** `1571b0380bd7`: 4 breaking, 5 info
  - removed the enum value `false` of the request property `IncludeMetadataCustomHeaders`
  - removed the enum value `false` of the request property `Secure`
  - removed the enum value `true` of the request property `IncludeMetadataCustomHeaders`
  - removed the enum value `true` of the request property `Secure`
  - …5 more

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/texml/Accounts/:account_sid/Calls/:call_sid/Siprec.json/post.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/f82938f53ff4?raw)