digitaluapi

<back to all web services

SendSmsRequest

Requires Authentication
Requires any of the roles:Client, Admin, Partner
The following routes are available for this service:
POST/communication/message/smsSends an SMS to phone numbers provided.
SendSmsRequest Parameters:
NameParameterData TypeRequiredDescription
MessagesbodyList<SmsMessage>YesMessages to be Sent
SmsMessage Parameters:
NameParameterData TypeRequiredDescription
channelformstringNo
toformstringNo
contentformstringNo
clientMessageIdformstringNo
SmsMsgResponse Parameters:
NameParameterData TypeRequiredDescription
grandcomMsgResponseformGrandcomMsgResponseNo
clickatellMsgResponseformClickatellMessageResponseNo
SMPPMsgResponseformSMPPMsgResponseNo
errorformstringNo
ResponseStatusformResponseStatusNo
GrandcomMsgResponse Parameters:
NameParameterData TypeRequiredDescription
messagesformList<GrandcomResponseMsg>No
errorformstringNo
ResponseStatusformResponseStatusNo
GrandcomResponseMsg Parameters:
NameParameterData TypeRequiredDescription
apiMessageIdformstringNo
acceptedformboolNo
toformstringNo
errorformstringNo
hasErrorformboolNo
msgformGrandcomMessageNo
GrandcomMessage Parameters:
NameParameterData TypeRequiredDescription
channelformstringNo
toformstringNo
contentformstringNo
clientMessageIdformstringNo
ClickatellMessageResponse Parameters:
NameParameterData TypeRequiredDescription
messagesformList<ClickatellResponsesMsg>No
errorformstringNo
ResponseStatusformResponseStatusNo
ClickatellResponsesMsg Parameters:
NameParameterData TypeRequiredDescription
apiMessageIdformstringNo
acceptedformboolNo
toformstringNo
errorformstringNo
msgformClickatellMessageNo
ClickatellMessage Parameters:
NameParameterData TypeRequiredDescription
channelformstringNo
toformstringNo
contentformstringNo
clientMessageIdformstringNo
SMPPMsgResponse Parameters:
NameParameterData TypeRequiredDescription
messagesformList<SMPPResponseMsg>No
errorformstringNo
ResponseStatusformResponseStatusNo
SMPPResponseMsg Parameters:
NameParameterData TypeRequiredDescription
apiMessageIdformstringNo
acceptedformboolNo
toformstringNo
errorformstringNo
msgformSMPPMessageNo
SMPPMessage Parameters:
NameParameterData TypeRequiredDescription
channelformstringNo
toformstringNo
contentformstringNo
clientMessageIdformstringNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /communication/message/sms HTTP/1.1 
Host: duengageapi.uat.scadsoftware.com 
Accept: application/json
Content-Type: application/json
Content-Length: length

{"Messages":[{"channel":"String","to":"String","content":"String","clientMessageId":"String"}]}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"grandcomMsgResponse":{"messages":[{"apiMessageId":"String","accepted":false,"to":"String","error":"String","hasError":false,"msg":{"channel":"String","to":"String","content":"String","clientMessageId":"String"}}],"error":"String","ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}},"clickatellMsgResponse":{"messages":[{"apiMessageId":"String","accepted":false,"to":"String","error":"String","msg":{"channel":"String","to":"String","content":"String","clientMessageId":"String"}}],"error":"String","ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}},"SMPPMsgResponse":{"messages":[{"apiMessageId":"String","accepted":false,"to":"String","error":"String","msg":{"channel":"String","to":"String","content":"String","clientMessageId":"String"}}],"error":"String","ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}},"error":"String","ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}}