Skip to main content


  • How to enable SMS/MMS through TollFree numbers?

    By default, TollFree numbers are not whitelisted for your account. You need to connect with Plivo to get your account & use case whitelisted. Post this verification process, you will be able to send SMS/MMS through TollFree numbers. Listed below is the process to enable SMS/MMS in your TollFree numbers.

    To enable SMS/MMS in your Tollfree number:

    1. Fill the required details in this form:

    2. Raise a ticket to Plivo-Support referring to the email id used to fill the above form.

  • How do I add a line break in my SMS or MMS message?

    To include line breaks in your messages sent from Plivo, you may need to encode the line break \n in your code. Here’s an example of how this works:


    curl -X POST<auth_id>/Message/ \
      -u <auth_id>:<auth_token> -H 'Content-Type: application/json' \
      -d '{  "src" : "14845355114", 
      "dst" : "14845355111"  , 
      "text": "Here is my first line\nHere is my second line" 

    This example sends an outbound message from the sender (484) 535-5114 (+14845355114) to the recipient at (484) 535-5111 (+14845355111), and includes the following message:

    Here is my first line
    Here is my second line
    • Line 1 update with your Auth ID
    • Line 2 update with your Auth ID and Auth Token
    • Line 3 update with a valid sender/from number
    • Line 4 update with a valid destination number
    • Line 5 update with the desired message text
  • What countries do you support for SMS?

    Currently, we support inbound SMS in the following countries:

    United Kingdom
    United States

    Note: phone numbers that can receive SMS messages are labeled “SMS-enabled”.

    Outbound SMS:

    For outbound SMS, we support more than 200 countries. Please check our pricing page to get country-level details. 


  • What is the difference between promotional and transactional SMS messages?

     Promotional SMS: this type of message is sent with the objective of promoting a product or service. These messages are sales and marketing SMS’s which may or may not be solicited by the recipient.

     Transactional SMS: this type of message is sent to your customers with the purpose of passing on information necessary for using your product or service. For example: 

    a) SMS sent for two-factor authentication, one-time passwords, etc.

    b) Notifications regarding a product or service used by an existing customer, such as an appointment reminder. 

  • How to Export Message Detail Records (MDR) and Call Detail Records (CDR)

    Customers can generate the Message Detail Record (MDR) and Call Detail Record (CDR) reports directly from their Plivo Console

     To find your MDR and CDR, login to your account. Navigate to Voice/ SMS, Logs, Set the Date Range, and click on Export All.

    Call Detail Records (CDRs) and Message Detail Records (MDRs) will be retained in our transactional databases for a period of 90 days. Click here for more info

    If the logs are too large, exported logs will be emailed to your registered email address. If the logs are within the downloadable limit, the file will automatically be downloaded to your device. 

    The information included in your CDR/MDR will include: 

    For the downloaded file:

    Message UUID



    To Country ISO2


    Message Time    


    Error Code    

    Error Reason    


    Rate Per Unit (USD)    

    Carrier Surcharge Per Unit (USD)    

    Total Charge Per Unit (USD)    

    Total Charge (USD)


    For an emailed file:

    Message UUID








    Message Rate    

    Message Charge