POST - Send SMS v1 version
 

Purpose

Use this API to send only sms.
 

Authorization

HeaderKey

Description

Authorization*

Zoho-oauthtoken<space><ACCESS_TOKEN>

Accept*

Set to application/json.

Request URL

Method: POST

https://voice.zoho.com/rest/json/v1/sms/send

Scope: ZohoVoice.sms.CREATE

Parameters: 

Param Name

Data Type        

Description

senderId*

Number

Represents the Zoho Voice approved sender ID.

customerNumber*

Number

Represents a single or multiple destination phone numbers separated by commas.

 

Note: Maximum allowed is 10.

message*

String

Represents the content of the message to be sent. 

Can be up to 1000 characters.

statusCallback

URL

Represents the URL to which callback status notifications are sent.

 

Note: This uses URL-level authentication only.


Example: https://zoho.com/callback?zapikey=1003.5XXXXXXX59

dataCoding

Integer

Represents whether Unicode characters are detected.

 

Possible values:

  • 0 - English characters

  • 1 - Binary

  • 2 - Non-English characters

scheduledTime

String

Represents the scheduled time for message delivery in yyyy-mm-dd HH:MM:ss format.

timeZone

String

Represents the timezone used to schedule message delivery.

 

Example: Asia/Kolkata

Sample Request

Copiedcurl -X POST "https://voice.zoho.com/rest/json/v1/sms/send" \
  -H "Content-Type: application/json" \
  -H "Authorization: Zoho-oauthtoken <your_access_token>" \
  -d '{
        "senderId": "+1****",
        "customerNumber": "+1****",
        "message": "Hi there!"
 }

Sample Response - Success

Copied{
  "code": "ZVSMS-2000",
  "send": {
    "multipartCount": 1,
    "country": "in",
    "submittedTime": 1764831248860,
    "customerNumber": "+1****",
    "message": "Hi there!",
    "userName": "John",
    "customerName": "Jacobs",
    "senderId": "+1*****",
    "messageType": "OUTGOING",
    "sentTime": "2022-12-04 12:24",
    "logid": "40319ae8-23c1-4117-b814-a719ec9542ec",
    "email": "john@zylker.com",
    "status": "IN_QUEUE"
  },
  "status": "SUCCESS"
}

Sample Response - Error

Copied{
 "status": "ERROR",
 "code": "ZVSMS-4027",
 "message": "Bad Request"
}