Revolutionize communications with
our programmable SMS API
Take advantage of automating SMS and MMS
communications through our SMS APIs to
conveniently reach mobile users.
Enable any of your business phone numbers in your RingCentral
account to send and receive messages as well as enable a single
interface to send more than 30 types of file formats. A carrier-grade
global network ensures immediate delivery across geographies.
Automate your applications to record detailed delivery
information of messages or receive notifications for new
or updated messages.
Try for free

Send and receive text messages

Send and receive images, videos, and files with MMS

Long message concatenation for more detailed SMS messages

Group SMS and MMS to chat with multiple users

Two-way multi-source API and phone text messaging

Automated text message notifications via SMS webhooks

Single SMS endpoint and interface

SMS and MMS message delivery and read status

Unicode support for sending texts in many languages

Text message storage and deletion
SMS API code samples
Adding SMS to your application couldn’t be easier with our SDKs for Java, C#, PHP, JavaScript, and more.
- JavaScript
- Python
- PHP
- Java
- C#
- Ruby
function send_sms(){
platform.post('/account/~/extension/~/sms', {
from: {'phoneNumber': RINGCENTRAL_USERNAME},
to: [{'phoneNumber': RECIPIENT}],
text: 'Hello World from JavaScript'
});
}
platform.post('/restapi/v1.0/account/~/extension/~/sms',
{
'from' : { 'phoneNumber': RINGCENTRAL_USERNAME },
'to' : [ {'phoneNumber': RECIPIENT} ],
'text' : 'Hello World from Python'
})
$resp = $platform->post('/account/~/extension/~/sms',
array(
'from' => array ('phoneNumber' => $RINGCENTRAL_USERNAME),
'to' => array(array('phoneNumber' => $RECIPIENT)),
'text' => 'Hello World from PHP'
));
public static void sendSms() throws RestException, IOException {
RestClient rc = new RestClient(RINGCENTRAL_CLIENTID, RINGCENTRAL_CLIENTSECRET, RINGCENTRAL_SERVER);
rc.authorize(RINGCENTRAL_USERNAME, RINGCENTRAL_EXTENSION, RINGCENTRAL_PASSWORD);
CreateSMSMessage postParameters = new CreateSMSMessage();
postParameters.from = new MessageStoreCallerInfoRequest().phoneNumber(RINGCENTRAL_USERNAME);
postParameters.to = new MessageStoreCallerInfoRequest[]{new MessageStoreCallerInfoRequest().phoneNumber(RECIPIENT_NUMBER)};
postParameters.text = "Hello World from Java";
var response = rc.restapi().account().extension().sms().post(postParameters);
}
static private async Task send_sms()
{
RestClient rc = new RestClient(RINGCENTRAL_CLIENTID, RINGCENTRAL_CLIENTSECRET, false);
await rc.Authorize(RINGCENTRAL_USERNAME, RINGCENTRAL_EXTENSION, RINGCENTRAL_PASSWORD);
var parameters = new CreateSMSMessage();
parameters.from = new MessageStoreCallerInfoRequest { phoneNumber = RINGCENTRAL_USERNAME };
parameters.to = new MessageStoreCallerInfoRequest[] { new MessageStoreCallerInfoRequest { phoneNumber = RECIPIENT } };
parameters.text = "Hello World from C#";
var resp = await rc.Restapi().Account().Extension().Sms().Post(parameters);
}
resp = rc.post('/restapi/v1.0/account/~/extension/~/sms', payload: {
to: [{phoneNumber: RECIPIENT}],
from: {phoneNumber: RINGCENTRAL_USERNAME},
text: 'Hello World from Ruby'
})
Simple API pricing, starting at free!
The RingCentral API is included with select RingCentral Office® plans. High Volume and
International SMS are available as add-ons with a minimal per message fee.
Low-volume SMS (P2P)
Send up to
200 messages per day
FREE
HIGH-VOLUME SMS (A2P)
Send up to
250,000 messages per day
$0.007
per message sent/received
International SMS
Limitations depend on carriers
and regulations in each country
in Admin Portal
Request High Volume SMS to be enabled by contacting Support. See our SMS FAQs below for more details.
SMS API frequently asked questions
To help you get started sending and receiving text messages, here are some of the most common questions we get. Of course, you can always ask our community or contact our developer support for any questions you might have.
How can I get SMS API?
What is RingCentral SMS API?
Does RingCentral support MMS?
What’s the difference between P2P and A2P SMS?
P2P, otherwise referred to as person-to-person or peer-to-peer SMS is messaging that mimics human behavior and adheres to the CTIA guidelines of a maximum of:
- 15-60 SMS messages per minute
- 1,000 SMS messages per day
- 1 unique phone number per sender
- 100 recipients per message
- 1:1 ratio for sending and receiving SMS
- 25 repetitive messages
If you need to send messages at a faster rate, need to send to more numbers, or need to send more messages or you do not have a 1:1 send/receive ratio, you should evaluate using our High Volume SMS solution.
When should I use High Volume (A2P) SMS instead of P2P SMS?
High Volume SMS should be used when you want to use your existing toll-free number to send SMS messages, you need to send repetitive messages, your recipients will not be replying to your messages, or you need to send more than 200 messages from a number per day. Unlike traditional SMS, High Volume SMS will not be blocked by carriers if you exceed any of the following CTIA guidelines:
- 15-60 SMS messages per minute
- 1,000 SMS messages per day
- 1 unique phone number per sender
- 100 recipients per message
- 1:1 ratio for sending and receiving SMS
- 25 repetitive messages
What is the maximum number of SMS messages I can send per minute?
When using low-volume or P2P SMS, you are limited to sending a maximum of 40 messages per minute per RingCentral number.
To messages more quickly (up to 1 message per second for commercial long code and up to 3 messages per second for toll-free numbers) please contact developer support to have your RingCentral number enabled, and utilize our High Volume SMS documentation.
Please note fees apply for international, toll-free, and High Volume SMS.
How do I enable and use High Volume SMS?
To request high-volume SMS capabilities for your long code or toll-free number, please contact our Support team.
While you are talking to our support team, be sure to ask them about your daily spending limits to ensure that you have a large enough limit to meet your high-volume SMS needs.
Be sure to also utilize our High Volume SMS API to take advantage of faster sending rates, batch transactions, and queuing. You can find our High Volume SMS API documentation here.
Get more than communications.
Be part of the RingCentral community.

Live chat

Developer forum

RingCentral Professional Services™
