Cannot find phone_sms:write scope for POST /phone/sms/messages in Server‑to‑Server OAuth app

Phone
1

Hi everyone,

I’m building a CRM that integrates with Zoom Phone using a Server‑to‑Server OAuth app. I can successfully read call logs and SMS sessions with phone:read:admin and phone_sms:read.

I now want to send SMS via POST /phone/sms/messages. The docs list these required scopes: phone:write, phone:write:admin, phone_sms:write, phone_sms:write:admin, plus granular scopes phone:read:sms_message and phone:read:sms_message:admin. However, in the S2S app scope picker I only see the read scopes; none of the phone_sms:write* scopes appear at all.

My setup:

  • App type: Server‑to‑Server OAuth

  • License: Zoom Phone Pro

  • Scopes enabled: phone:read:admin, phone_sms:read, phone:write:admin

  • Working endpoints: call logs and SMS sessions

  • Desired endpoint: POST /phone/sms/messages

Questions:

  1. Are phone_sms:write / phone_sms:write:admin actually available for S2S apps, or not supported yet even though they’re in the docs?

  2. For now, should we use only the granular read scopes (phone:read:sms_message, phone:read:sms_message:admin) to call this POST endpoint, as mentioned in other threads?

  3. If we need to send SMS on behalf of other users and call queues, is a user‑managed OAuth app required instead of S2S?

Any clarification on the correct scopes and app type for sending SMS via API would be greatly appreciated. Thanks!

2

Hi @Danny3
Thanks for reaching out to us!

This is a known issue and we are working on a fix. For now you can use the phone:read:sms_message:admin and phone:read:sms_message scopes, even though it is a POST request.

You should only be looking into Granular scopes and we are aware that the write scopes are not available in a S2S app.

For now, sending SMSs on behalf of other users or call queues is not supported using an admin managed app, so yes you will need to create a user managed oauth app for each user to be able to send SMSs from each user

We are looking to support sendind SMSs on behalf of others in the near future but we do not have a set date

Let me know if this helps