Skip to main content
Question

SMS API restriction: existing phone number not usable with JWT extension (“Phone number doesn't belong to extension”)

  • April 29, 2026
  • 1 reply
  • 6 views

Hi RingCentral Team,

I am implementing SMS functionality using RingCentral REST API with JWT authentication (server-to-server app).

Environment:

  • JWT authentication flow
  • Existing number available under Admin → Phone System → Phone Numbers
  • Number assigned to a Softphone extension

Issue:

When sending SMS via API, I receive:

“Phone number doesn't belong to extension”

This happens even though the phone number exists in the account and is active.

Questions:

  1. Is SMS sending restricted to phone numbers assigned only to the authenticated JWT extension?
  2. Can existing numbers be reused across multiple extensions for SMS sending?
  3. What is the correct way to bind or select an existing phone number as a valid SMS sender for JWT-based API usage?
  4. Is there any configuration required to enable this use case without purchasing a new number?

Goal:

Use an existing company phone number as the SMS sender for OTP via API without creating a new number or extension.

Thanks in advance for the clarification.

1 reply

PhongVu
Community Manager
Forum|alt.badge.img
  • Community Manager
  • April 29, 2026

The error message clearly said that the phone number does not belong to the user extension that being authenticated with the app (using its JWT). This is clear for user extension direct number(s).

In your case, it seems that you want to use the company phone number(s) (like the main company number or the phone numbers that assigned to the company auto-receptionist). You need to check the SMS recipients setting in your account admin portal. Select the “Phone System” tab, choose the “Auto-Receptionist” → “General Settings” → “Main Site” (Or Company if no sub site avail.) → “Call Handling” → “Settings”. You should see something like this

 

 

Scroll down and you will see this

 

 

The selected SMS recipient is the one who can send SMS messages from your main company number and other company number(s). 

Learn more from this dev guide article.