Skip to main content

Recording start


Start recording the call. Recording will stop on call hang-up, or can be initiated via the Stop Recording command.

Expected Webhooks:

  • call.recording.saved


Path Parameters

    call_control_id stringrequired

    Unique identifier and token for controlling the call



Start recording audio request

    format stringrequired

    Possible values: [wav, mp3]

    The audio file format used when storing the call recording. Can be either mp3 or wav.

    channels stringrequired

    Possible values: [single, dual]

    When dual, final audio file will be stereo recorded with the first leg on channel A, and the rest on channel B.

    client_state string

    Use this field to add state to every subsequent webhook. It must be a valid Base-64 encoded string.

    command_id string

    Use this field to avoid duplicate commands. Telnyx will ignore any command with the same command_id for the same call_control_id.

    play_beep boolean

    If enabled, a beep sound will be played at the start of a recording.

    max_length int32

    Default value: 0

    Defines the maximum length for the recording in seconds. The minimum value is 0. The maximum value is 14400. The default value is 0 (infinite)

    timeout_secs int32

    Default value: 0

    The number of seconds that Telnyx will wait for the recording to be stopped if silence is detected. The timer only starts when the speech is detected. Please note that call transcription is used to detect silence and the related charge will be applied. The minimum value is 0. The default value is 0 (infinite)

    recording_track string

    Possible values: [both, inbound, outbound]

    Default value: both

    The audio track to be recorded. Can be either both, inbound or outbound. If only single track is specified (inbound, outbound), channels configuration is ignored and it will be recorded as mono (single channel).

    trim string

    Possible values: [trim-silence]

    When set to trim-silence, silence will be removed from the beginning and end of the recording.

    custom_file_name string

    The custom recording file name to be used instead of the default call_leg_id. Telnyx will still add a Unix timestamp suffix.


200: Successful response upon making a call control command.

default: Unexpected error