emSoapService Web Service

emSoapService

Click here for a complete list of operations.

SendSimpleExtendedMessage

Sends a single extended message body to multiple recipients, returns message references.

Test

To test the operation using the HTTP POST protocol, click the 'Invoke' button.

Parameter	Value
Account:
Password:
Subject:
UserReference:
ReplyType:
ReplyURL:
ReplyEmail:
Scheduled:
DeliveryReceipt:
Originator:
Expiry:
MobileCSV:
MessageBody:

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /smsservice.asmx HTTP/1.1
Host: emsoap.net
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://www.emsoap.net/SendSimpleExtendedMessage"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <SendSimpleExtendedMessage xmlns="https://www.emsoap.net">
      <Account>string</Account>
      <Password>string</Password>
      <Subject>string</Subject>
      <UserReference>string</UserReference>
      <ReplyType>Email or URL or URL_EMail or Collect</ReplyType>
      <ReplyURL>string</ReplyURL>
      <ReplyEmail>string</ReplyEmail>
      <Scheduled>string</Scheduled>
      <DeliveryReceipt>unsignedByte</DeliveryReceipt>
      <Originator>string</Originator>
      <Expiry>string</Expiry>
      <MobileCSV>string</MobileCSV>
      <MessageBody>string</MessageBody>
    </SendSimpleExtendedMessage>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <SendSimpleExtendedMessageResponse xmlns="https://www.emsoap.net">
      <SendSimpleExtendedMessageResult>
        <result>SUCCESS or INVALID_USER or INVALID_MOBILE_NUMBER or DATE_ERROR or DATABASE_ERROR or FAILURE or CANNOT_CONNECT_TO_THE_DATABASE or USER_LIMIT_REACHED or COMPANY_LIMIT_REACHED or COMPANY_BLOCKED or DUPLICATED_MESSAGE or MESSAGE_DOES_NOT_EXIST or ORIGINATOR_NOT_ALLOWED or SUBMITTED or ACCESS_DENIED</result>
        <Message_Status>
          <MessageStatus>
            <MessageID>int</MessageID>
            <Mobile>string</Mobile>
            <result>SUCCESS or INVALID_USER or INVALID_MOBILE_NUMBER or DATE_ERROR or DATABASE_ERROR or FAILURE or CANNOT_CONNECT_TO_THE_DATABASE or USER_LIMIT_REACHED or COMPANY_LIMIT_REACHED or COMPANY_BLOCKED or DUPLICATED_MESSAGE or MESSAGE_DOES_NOT_EXIST or ORIGINATOR_NOT_ALLOWED or SUBMITTED or ACCESS_DENIED</result>
          </MessageStatus>
          <MessageStatus>
            <MessageID>int</MessageID>
            <Mobile>string</Mobile>
            <result>SUCCESS or INVALID_USER or INVALID_MOBILE_NUMBER or DATE_ERROR or DATABASE_ERROR or FAILURE or CANNOT_CONNECT_TO_THE_DATABASE or USER_LIMIT_REACHED or COMPANY_LIMIT_REACHED or COMPANY_BLOCKED or DUPLICATED_MESSAGE or MESSAGE_DOES_NOT_EXIST or ORIGINATOR_NOT_ALLOWED or SUBMITTED or ACCESS_DENIED</result>
          </MessageStatus>
        </Message_Status>
      </SendSimpleExtendedMessageResult>
    </SendSimpleExtendedMessageResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /smsservice.asmx HTTP/1.1
Host: emsoap.net
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <SendSimpleExtendedMessage xmlns="https://www.emsoap.net">
      <Account>string</Account>
      <Password>string</Password>
      <Subject>string</Subject>
      <UserReference>string</UserReference>
      <ReplyType>Email or URL or URL_EMail or Collect</ReplyType>
      <ReplyURL>string</ReplyURL>
      <ReplyEmail>string</ReplyEmail>
      <Scheduled>string</Scheduled>
      <DeliveryReceipt>unsignedByte</DeliveryReceipt>
      <Originator>string</Originator>
      <Expiry>string</Expiry>
      <MobileCSV>string</MobileCSV>
      <MessageBody>string</MessageBody>
    </SendSimpleExtendedMessage>
  </soap12:Body>
</soap12:Envelope>

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <SendSimpleExtendedMessageResponse xmlns="https://www.emsoap.net">
      <SendSimpleExtendedMessageResult>
        <result>SUCCESS or INVALID_USER or INVALID_MOBILE_NUMBER or DATE_ERROR or DATABASE_ERROR or FAILURE or CANNOT_CONNECT_TO_THE_DATABASE or USER_LIMIT_REACHED or COMPANY_LIMIT_REACHED or COMPANY_BLOCKED or DUPLICATED_MESSAGE or MESSAGE_DOES_NOT_EXIST or ORIGINATOR_NOT_ALLOWED or SUBMITTED or ACCESS_DENIED</result>
        <Message_Status>
          <MessageStatus>
            <MessageID>int</MessageID>
            <Mobile>string</Mobile>
            <result>SUCCESS or INVALID_USER or INVALID_MOBILE_NUMBER or DATE_ERROR or DATABASE_ERROR or FAILURE or CANNOT_CONNECT_TO_THE_DATABASE or USER_LIMIT_REACHED or COMPANY_LIMIT_REACHED or COMPANY_BLOCKED or DUPLICATED_MESSAGE or MESSAGE_DOES_NOT_EXIST or ORIGINATOR_NOT_ALLOWED or SUBMITTED or ACCESS_DENIED</result>
          </MessageStatus>
          <MessageStatus>
            <MessageID>int</MessageID>
            <Mobile>string</Mobile>
            <result>SUCCESS or INVALID_USER or INVALID_MOBILE_NUMBER or DATE_ERROR or DATABASE_ERROR or FAILURE or CANNOT_CONNECT_TO_THE_DATABASE or USER_LIMIT_REACHED or COMPANY_LIMIT_REACHED or COMPANY_BLOCKED or DUPLICATED_MESSAGE or MESSAGE_DOES_NOT_EXIST or ORIGINATOR_NOT_ALLOWED or SUBMITTED or ACCESS_DENIED</result>
          </MessageStatus>
        </Message_Status>
      </SendSimpleExtendedMessageResult>
    </SendSimpleExtendedMessageResponse>
  </soap12:Body>
</soap12:Envelope>

HTTP GET

The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.

GET /smsservice.asmx/SendSimpleExtendedMessage?Account=string&Password=string&Subject=string&UserReference=string&ReplyType=string&ReplyURL=string&ReplyEmail=string&Scheduled=string&DeliveryReceipt=string&Originator=string&Expiry=string&MobileCSV=string&MessageBody=string HTTP/1.1
Host: emsoap.net

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<SendExtendedMessage_Response xmlns="https://www.emsoap.net">
  <result>SUCCESS or INVALID_USER or INVALID_MOBILE_NUMBER or DATE_ERROR or DATABASE_ERROR or FAILURE or CANNOT_CONNECT_TO_THE_DATABASE or USER_LIMIT_REACHED or COMPANY_LIMIT_REACHED or COMPANY_BLOCKED or DUPLICATED_MESSAGE or MESSAGE_DOES_NOT_EXIST or ORIGINATOR_NOT_ALLOWED or SUBMITTED or ACCESS_DENIED</result>
  <Message_Status>
    <MessageStatus>
      <MessageID>int</MessageID>
      <Mobile>string</Mobile>
      <result>SUCCESS or INVALID_USER or INVALID_MOBILE_NUMBER or DATE_ERROR or DATABASE_ERROR or FAILURE or CANNOT_CONNECT_TO_THE_DATABASE or USER_LIMIT_REACHED or COMPANY_LIMIT_REACHED or COMPANY_BLOCKED or DUPLICATED_MESSAGE or MESSAGE_DOES_NOT_EXIST or ORIGINATOR_NOT_ALLOWED or SUBMITTED or ACCESS_DENIED</result>
    </MessageStatus>
    <MessageStatus>
      <MessageID>int</MessageID>
      <Mobile>string</Mobile>
      <result>SUCCESS or INVALID_USER or INVALID_MOBILE_NUMBER or DATE_ERROR or DATABASE_ERROR or FAILURE or CANNOT_CONNECT_TO_THE_DATABASE or USER_LIMIT_REACHED or COMPANY_LIMIT_REACHED or COMPANY_BLOCKED or DUPLICATED_MESSAGE or MESSAGE_DOES_NOT_EXIST or ORIGINATOR_NOT_ALLOWED or SUBMITTED or ACCESS_DENIED</result>
    </MessageStatus>
  </Message_Status>
</SendExtendedMessage_Response>

HTTP POST

The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /smsservice.asmx/SendSimpleExtendedMessage HTTP/1.1
Host: emsoap.net
Content-Type: application/x-www-form-urlencoded
Content-Length: length

Account=string&Password=string&Subject=string&UserReference=string&ReplyType=string&ReplyURL=string&ReplyEmail=string&Scheduled=string&DeliveryReceipt=string&Originator=string&Expiry=string&MobileCSV=string&MessageBody=string

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<SendExtendedMessage_Response xmlns="https://www.emsoap.net">
  <result>SUCCESS or INVALID_USER or INVALID_MOBILE_NUMBER or DATE_ERROR or DATABASE_ERROR or FAILURE or CANNOT_CONNECT_TO_THE_DATABASE or USER_LIMIT_REACHED or COMPANY_LIMIT_REACHED or COMPANY_BLOCKED or DUPLICATED_MESSAGE or MESSAGE_DOES_NOT_EXIST or ORIGINATOR_NOT_ALLOWED or SUBMITTED or ACCESS_DENIED</result>
  <Message_Status>
    <MessageStatus>
      <MessageID>int</MessageID>
      <Mobile>string</Mobile>
      <result>SUCCESS or INVALID_USER or INVALID_MOBILE_NUMBER or DATE_ERROR or DATABASE_ERROR or FAILURE or CANNOT_CONNECT_TO_THE_DATABASE or USER_LIMIT_REACHED or COMPANY_LIMIT_REACHED or COMPANY_BLOCKED or DUPLICATED_MESSAGE or MESSAGE_DOES_NOT_EXIST or ORIGINATOR_NOT_ALLOWED or SUBMITTED or ACCESS_DENIED</result>
    </MessageStatus>
    <MessageStatus>
      <MessageID>int</MessageID>
      <Mobile>string</Mobile>
      <result>SUCCESS or INVALID_USER or INVALID_MOBILE_NUMBER or DATE_ERROR or DATABASE_ERROR or FAILURE or CANNOT_CONNECT_TO_THE_DATABASE or USER_LIMIT_REACHED or COMPANY_LIMIT_REACHED or COMPANY_BLOCKED or DUPLICATED_MESSAGE or MESSAGE_DOES_NOT_EXIST or ORIGINATOR_NOT_ALLOWED or SUBMITTED or ACCESS_DENIED</result>
    </MessageStatus>
  </Message_Status>
</SendExtendedMessage_Response>