Recordings

Call recordings now have their own endpoint in the Platform API. Get a recording hands you a download link for a call’s audio whenever you ask, so there is no link to store.

It replaces the recording_url field in the Get a call and List calls responses. That field is deprecated and becomes unavailable on January 10, 2027. The field keeps working until then, so you can switch at your own pace. Get a call and List calls stay available after that date.

Who is affected

You are affected if anything you have built reads recording_url from the calls endpoints: a script that downloads call audio, a CRM sync that stores the recording link with the call, or a Zapier or Make workflow that maps the field to another tool.

You are also affected if you store the recording link from the post-call webhook. The webhook keeps sending it, but from January 10, 2027 the link expires after 24 hours.

You are not affected if you only listen to recordings in the dashboard call logs.

What changes for you

Today you read a link from the call record. The recordings endpoint takes the call ID and the same API key as the rest of the Platform API, and answers with a redirect to a signed download link. Each link is valid for 24 hours from when it was first issued, and repeated requests within that window return the same link. A client that follows redirects receives the audio file directly.

Because you can request a link whenever you need one, there is nothing to store. Keep the call ID and request the recording whenever you need it.

If the call has no recording, or it is not in your workspace, the response is 404. Handle it the way you handle an empty recording_url today.

Recommended steps

1. Find every place that reads recording_url from the calls endpoints.
2. Replace each one with a request to the recordings endpoint, made at the moment you need the audio. Try it below with one of your own call IDs.
3. Treat a 404 response as “no recording”.
4. Stop storing recording links. Keep the call ID instead, and download the audio file if you need a permanent copy.

What happens on January 10, 2027

After this date the recording_url field in the calls endpoints no longer returns a recording link, and anything still reading it stops receiving recordings. The post-call webhook still includes a recording link, but it is valid for 24 hours only. The recordings endpoint is the way to fetch call audio at any later time.

FAQ