Objective
This article explains how to create a recording configuration for Programmable Voice so that your calls and conferences are recorded consistently — with the channel layout, silence trimming, track selection, and status callbacks you want — without having to set those options on every individual call.
Product
Programmable Voice
Environment
Twilio Console
User Account Permission/Role(s) Required
Your user role must allow updating Voice configurations. Without it, the Create configuration action is not offered.
Procedure
- In the Twilio Console, select Communications in the left sidebar.
- Select Voice, then Recordings.
- Select the Configurations tab, then Recording. The Recording configurations page lists any configurations you already have.
- Select Create configuration to open the guided setup.
- On the Name configuration step, enter a Recording configuration name. Optionally add a Description (up to 128 characters) to record what the configuration is for, then select Next.
- On the Composition policy step, choose your Channel (Dual to record each party on a separate channel, or Mono to record all parties into one channel), your Trim silence option (Do not trim or Trim silence), and your Track (Both, Inbound, or Outbound). The defaults are Dual, Do not trim, and Both. Select Next.
- On the Callback settings step, optionally fill in the Call recording status callback and Conference recording status callback sections. For each, enter a URL, choose an HTTP method (POST or GET), and select the Events you want to be notified about (In-progress, Completed, Absent, Failed). Select Next.
- On the Features step, optionally select up to three batch transcription configurations to transcribe recordings made with this configuration, each with an optional description. Select Next.
- On the Summary step, review the values you entered. Select Create configuration.
- A confirmation appears reading "Recording configuration created" and you are taken to the new configuration's detail page. The configuration also appears in the Recording configurations list.
Additional Information
- Callback settings are optional, but if you provide a callback URL you must select at least one event for it.
- If your account is set up for PCI, HIPAA, recording encryption, or external recording storage, the Features step is not shown and the setup goes straight from Callback settings to Summary.
- To abandon the setup, select Cancel, then confirm with Close without saving in the Close without saving? dialog. You are returned to the Recording configurations list and nothing is saved.
- Recording configurations are supported only in the United States (US1) region. In Australia (AU1) the Configurations tab shows a message reading "Unavailable in Australia (AU1)".
This content was generated by AI and reviewed, edited, and verified by a human.