/api/v6/callblasting/audiosUpload a pre-recorded audio
Puts an audio in your catalog to reuse across as many calls as you want.
Scope and limits
API key with the callblasting service enabled
30 requests per minute
- Accepted formats: wav, mp3, ogg and m4a. Up to 20 MB.
Uploads a pre-recorded audio that stays in your catalog to reuse across as many calls as you want. Accepts wav, mp3, ogg and m4a, up to 20 MB, and we prepare it for the voice network.
Returns an id you later send as audioId when creating a call. Uploading the same audio twice returns the same id: nothing is duplicated.
Request body
multipart/form-datafilenameResponses
Audio uploaded, or reused if it already existed.
{
"success": true,
"data": {
"id": "01J9Z4M7K2QABCDEF5GHTV3WXY",
"durationMs": 4200,
"format": "mp3",
"sizeBytes": 67200,
"cached": false
},
"meta": {
"requestId": "8f0c0e2a4b1d4c8fae2b7a91e0c5d3f6",
"timestamp": "2026-06-23T15:04:05+00:00",
"responseTimeMs": 180.4
}
}Missing file, unsupported format, or the audio could not be processed.
Invalid or missing credentials.
The API key does not have the callblasting service enabled.
The audio is empty or exceeds the maximum allowed size.
Request limit exceeded.
Possible errors
Codes this endpoint can return in error.code. The full detail lives in the catalog.
AUTH_REQUIREDNo Bearer token was sent, and every call requires one.401AUTH_INVALID_KEYThe API key is not recognized: wrong format, revoked or expired.401AUTH_SERVICE_NOT_ALLOWEDThe key is not allowed to use the service behind this endpoint.400BAD_REQUESTWe could not parse your request.403ACCOUNT_READ_ONLYRead-only mode: only GET, HEAD and OPTIONS pass.429RATE_TPS_EXCEEDEDYou exceeded your organization quota for this endpoint.