---
title: "Create a Transcription"
method: POST
path: "/2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Transcriptions.json"
tags: ["Api20100401CallTranscription"]
---

# Create a Transcription

`POST /2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Transcriptions.json`

## Request

- Base URL: `https://api.twilio.com`
- URL: `https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Transcriptions.json`
- Auth: HTTP basic

Create a Transcription

## Path parameters

- `AccountSid` string, required
- `CallSid` string, required

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

- object
  - `Name` string: The user-specified name of this Transcription, if one was given when the Transcription was created. This may be used to stop the Transcription.
  - `Track` 'inbound_track' | 'outbound_track' | 'both_tracks': One of `inbound_track`, `outbound_track`, `both_tracks`.
  - `StatusCallbackUrl` string, uri: Absolute URL of the status callback.
  - `StatusCallbackMethod` 'GET' | 'POST', http-method: The http method for the status_callback (one of GET, POST).
  - `InboundTrackLabel` string: Friendly name given to the Inbound Track
  - `OutboundTrackLabel` string: Friendly name given to the Outbound Track
  - `PartialResults` boolean: Indicates if partial results are going to be sent to the customer
  - `LanguageCode` string: Language code used by the transcription engine, specified in [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) format
  - `TranscriptionEngine` string: Definition of the transcription engine to be used, among those supported by Twilio
  - `ProfanityFilter` boolean: indicates if the server will attempt to filter out profanities, replacing all but the initial character in each filtered word with asterisks
  - `SpeechModel` string: Recognition model used by the transcription engine, among those supported by the provider
  - `Hints` string: A Phrase contains words and phrase "hints" so that the speech recognition engine is more likely to recognize them.
  - `EnableAutomaticPunctuation` boolean: The provider will add punctuation to recognition result
  - `IntelligenceService` string: The SID or unique name of the [Intelligence Service](https://www.twilio.com/docs/conversational-intelligence/api/service-resource) for persisting transcripts and running post-call Language Operators
  - `ConversationConfiguration` string: The ID of the Conversations Configuration for customizing conversation behavior in Intelligence Service
  - `ConversationId` string: The ID of the Conversation for associating this Transcription with an existing Conversation in Intelligence Service
  - `TranscriptionConfigurationId` string: The ID of the RealTimeTranscription Configuration for configuring all the non-default behaviors in one go.
  - `EnableProviderData` boolean: Whether the callback includes raw provider data.

## Response `200`

OK

- ApiV2010AccountCallRealtimeTranscription
  - `sid` string, nullable: The SID of the Transcription resource.
  - `account_sid` string, nullable: The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created this Transcription resource.
  - `call_sid` string, nullable: The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the Transcription resource is associated with.
  - `name` string, nullable: The user-specified name of this Transcription, if one was given when the Transcription was created. This may be used to stop the Transcription.
  - `status` 'in-progress' | 'stopped': The status - one of `stopped`, `in-flight`
  - `date_updated` string, date-time-rfc-2822, nullable: The date and time in GMT that this resource was last updated, specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
  - `uri` string, nullable

## Changes

- **2026-05-06** (v2010) `a6753266b8b0`: 1 warning, 1 info
  - removed the request property `ConfigurationId`
  - added the new optional request property `TranscriptionConfigurationId`
- **2026-04-14** (v2010) `99cae87a6bb1`: 1 info
  - added the new optional request property `ConfigurationId`
- **2026-03-10** (v2010) `a922c3aef8aa`: 2 info
  - added the new optional request property `ConversationConfiguration`
  - added the new optional request property `ConversationId`
- **2026-01-22** (v2010) `943a5c407ebf`: 1 info
  - added the new optional request property `EnableProviderData`
- **2025-02-11** (v2010) `3714525762d3`: 1 breaking, 1 info
  - removed the success response with the status `201`
  - added the success response with the status `200`

[Operation history](https://skmtc.dev/twilio/apis/api-v2010/changes/2010-04-01/Accounts/:AccountSid/Calls/:CallSid/Transcriptions.json/post.md)

---

[API](https://skmtc.dev/twilio/apis/api-v2010.md) - [All operations](https://skmtc.dev/twilio/apis/api-v2010/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/api-v2010/revisions/bfdf249a1298?raw)