---
title: "Add call media"
slug: "add-call-media-v2callsidmedia-2"
updated: 2025-11-17T08:10:53Z
published: 2025-11-17T08:12:09Z
canonical: "help.gong.io/add-call-media-v2callsidmedia-2"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.gong.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Add call media (/v2/calls/{id}/media)

Put/v2/calls/{id}/media

Adds a call media, recorded by a telephony system (PBX) or other media recording facility. Gong accepts call recordings in various audio and video file formats, including WAV, MP3, MP4, MKV and FLAC. If uploading a dual-channel (stereo) file separated by speaker, make sure to specify which channel correspondsto the company team member (rep) in the parties/mediaChannelId parameter of the Add New Call operation.

Required authorizaton scope: 'api:calls:create'.

Path parametersidstringRequired

callId returned from 'Add New Call' request

Body parameters<select class='api-response-data' aria-label='Media type'><option value='5dc5c6ec-a3a7-4023-a0c5-53ec43e968ae'>multipart/form-data</option>
</select>object  mediaFilestring  (binary)    Required

The media file of the recording. You may attach files up to 1.5GB in size.

Responses201

Successfully registered the new call recording

<select class='api-response-data' aria-label='Media type'><option value='e5825e45-e5c6-4564-a36c-dbde331cc2df'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
callIdstring    

New call ID

Example7782342274025937895
urlstring    

The URL to the page in the Gong web application where the call is available.

Examplehttps://app.gong.io/call?id=7782342274025937895

400

Malformed request

<select class='api-response-data' aria-label='Media type'><option value='b4670748-2e43-4240-a2f6-a49018e3ab24'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

401

Access denied

<select class='api-response-data' aria-label='Media type'><option value='bf41dc0c-3f71-4037-86b5-4c353bda91f2'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

429

API request limit exceeded

HeadersRetry-AfterintegerNumber of seconds to wait before making a new request.
<select class='api-response-data' aria-label='Media type'><option value='70735634-938d-4cd8-a046-6b34aa8c2462'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

500

Failed to complete the operation due to an unexpected error

<select class='api-response-data' aria-label='Media type'><option value='2f1800e8-8a4c-4408-a6a6-ce798b264235'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string