API endpoint for List audio items gives 403 response

API and Webhooks
1

API Endpoint(s) and/or Zoom API Event(s)

/v2/phone/users/<user_id>/audios

Description
I am trying to get a list of Audio Items from a given user’s account using a server-to-server application with the correct scopes to see that information but getting an error response.

Error?
{
“code”: 403,
“message”: “You do not have permission.”
}

How To Reproduce

  1. Create a server-to-server application

  2. Set the scopes to: phone:read:list_audios,phone:read:list_audios:admin

  3. Try using this endpoint to get a users audio recordings: /v2/phone/users/<user_id>/audios

  4. Response is 403 error.

Other forum posts have noted similar issues and some sort of special whitelisting of a users account was required in the past. I’d like the full post but I guess I can’t with my account: /t/zoom-phone-api-audios-endpoint-issues/88406

2

A 403 usually means it’s not just scopes, but account permission. Make sure Zoom Phone is active on the account and the target user has a Zoom Phone license assigned. Also confirm you’re using an account-level Server-to-Server app installed by an admin — otherwise the endpoint will return 403 even with the correct scopes.

3

That GET /v2/phone/users/{userId}/audios call returns personal audio items, so it will 403 unless you’re calling as the same user (userId=me) or as an admin context that can access that user’s Phone data

For a Server-to-Server OAuth app, make sure the app is installed at the account level by an admin and your token actually includes the admin granular scope (phone:read:list_audios:admin) for this endpoint: https://developers.zoom.us/docs/integrations/oauth-scopes-granular/

If scopes/installation are correct, the other common reason is account entitlement: Zoom Phone must be enabled and the target user must have a Zoom Phone license (the endpoint doc lists these prerequisites)

4

Thanks for the replies. I’ve confirmed my app is installed by an admin (I am the admin). It is a server to server oath app with the “phone:read:list_audios:admin” scope. I’ve given my app all phone and user scopes in fact to see if that would help.

As far as the account entitlement my user has this license: Zoom Workplace Business Plus with US/CA Unlimited which best I can tell should be the correct license.

So it would seem to me I have all the prerequisites met.