HTTP Interface

Receive SMS Message

Our server can be configured to forward received SMS messages to you webserver via a HTTP POST.

To configure HTTP forwarding please login into your account and go to Preferences and then select the Forwarding tab.

Message Type:   
{
  "messages": [
    {
      "from": "44771012345",
      "to": "44771012346",
      "messageid": "21ba6a2ee454d1710d88f357df34fdb3f5",
      "channel": "sms",
      "sent": "2025-06-03T13:50:05-00:00",
      "content": {
        "msgtype": "text",
        "text": "Message Text"
      }
    }
  ]
}

Parameters:

fromThe mobile number of the message sender
toVirtual number the message was received on
messageidIntelliSoftware's allocated message id
channelMessage channel ('sms')
sentDate and time message was sent (in W3CDTF DateTime Format) Examples: 2010-02-03T13:50:05-00:00 = 3rd February 2010 13:50:05 GMT 2010-06-10T14:45:12+01:00 = 10th June 2010 14:45:12 BST
msgtypeMessage Type ('text')
textThe content of the text message 
{
  "messages": [
    {
      "from": "44771012345",
      "to": "44771012346",
      "messageid": "21ba6a2ee454d1710d88f357df34fdb3f5",
      "channel": "sms",
      "sent": "2025-06-03T13:50:05-00:00",
      "content": {
        "msgtype": "unicode",
        "text": "Simley Emoji \uD83D\uDE03"
      }
    }
  ]
}

Parameters:

fromThe mobile number of the message sender
toVirtual number the message was received on
messageidIntelliSoftware's allocated message id
channelMessage channel ('sms')
sentDate and time message was sent (in W3CDTF DateTime Format) Examples: 2010-02-03T13:50:05-00:00 = 3rd February 2010 13:50:05 GMT 2010-06-10T14:45:12+01:00 = 10th June 2010 14:45:12 BST
msgtypeMessage Type ('unicode')
textThe content of the text message 
{
  "messages": [
    {
      "from": "44771012345",
      "to": "44771012346",
      "messageid": "21ba6a2ee454d1710d88f357df34fdb3f5",
      "channel": "sms",
      "sent": "2025-06-03T13:50:05-00:00",
      "content": {
        "msgtype": "binary",
        "ud": "32F40100480E01000000000000000000000000000000000000000000000000000000000001247803000000E0080120CC0640000040080120CC06C00000479E7124F0EFFADCF64448892479B6DAC6CD4448F9241DB6DACECF44488124CDB6CD96CC44488924CDB6CD96CDE446712478E66D9EC6000000000000000000000000000000000000"
      }
    }
  ]
}

Parameters:

fromThe mobile number of the message sender
toVirtual number the message was received on
messageidIntelliSoftware's allocated message id
channelMessage channel ('sms')
sentDate and time message was sent (in W3CDTF DateTime Format) Examples: 2010-02-03T13:50:05-00:00 = 3rd February 2010 13:50:05 GMT 2010-06-10T14:45:12+01:00 = 10th June 2010 14:45:12 BST
msgtypeMessage Type ('binary')
udUser Data 
{
  "messages": [
    {
      "from": "44771012345",
      "to": "44771012346",
      "messageid": "21ba6a2ee454d1710d88f357df34fdb3f5",
      "channel": "whatsapp",
      "sent": "2025-06-03T13:50:05-00:00",
      "content": {
        "format": "wa_msgobject_v2",
        "msgobject": {
          "type": "text",
          "text": {
            "body": "MESSAGE_CONTENT"
          }
        }
      }
    }
  ]
}

Parameters:

fromThe mobile number of the message sender
toVirtual number the message was received on
messageidIntelliSoftware's allocated message id
channelMessage channel ('whatsapp')
sentDate and time message was sent (in W3CDTF DateTime Format) Examples: 2010-02-03T13:50:05-00:00 = 3rd February 2010 13:50:05 GMT 2010-06-10T14:45:12+01:00 = 10th June 2010 14:45:12 BST
formatFormat of WhatsApp Message Object. Latest version is 'wa_msgobject_v2'
msgobjectWhatsApp Message Object (Version 2.0) 
{
  "messages": [
    {
      "from": "44771012345",
      "to": "44771012346",
      "messageid": "21ba6a2ee454d1710d88f357df34fdb3f5",
      "channel": "whatsapp",
      "sent": "2025-06-03T13:50:05-00:00",
      "content": {
        "format": "wa_msgobject_v2",
        "msgobject": {
          "type": "button",
          "button": {
            "text": "BUTTON_TEXT"
          }
        }
      }
    }
  ]
}

Parameters:

fromThe mobile number of the message sender
toVirtual number the message was received on
messageidIntelliSoftware's allocated message id
channelMessage channel ('whatsapp')
sentDate and time message was sent (in W3CDTF DateTime Format) Examples: 2010-02-03T13:50:05-00:00 = 3rd February 2010 13:50:05 GMT 2010-06-10T14:45:12+01:00 = 10th June 2010 14:45:12 BST
formatFormat of WhatsApp Message Object. Latest version is 'wa_msgobject_v2'
msgobjectWhatsApp Message Object (Version 2.0) 
{
  "messages": [
    {
      "from": "44771012345",
      "to": "44771012346",
      "messageid": "21ba6a2ee454d1710d88f357df34fdb3f5",
      "channel": "whatsapp",
      "sent": "2025-06-03T13:50:05-00:00",
      "content": {
        "format": "wa_msgobject_v2",
        "msgobject": {
          "type": "reply",
          "interactive": {
            "title": "Button1",
            "id": "BUTTON1"
          }
        }
      }
    }
  ]
}

Parameters:

fromThe mobile number of the message sender
toVirtual number the message was received on
messageidIntelliSoftware's allocated message id
channelMessage channel ('whatsapp')
sentDate and time message was sent (in W3CDTF DateTime Format) Examples: 2010-02-03T13:50:05-00:00 = 3rd February 2010 13:50:05 GMT 2010-06-10T14:45:12+01:00 = 10th June 2010 14:45:12 BST
formatFormat of WhatsApp Message Object. Latest version is 'wa_msgobject_v2'
msgobjectWhatsApp Message Object (Version 2.0) 
{
  "messages": [
    {
      "from": "44771012345",
      "to": "44771012346",
      "messageid": "21ba6a2ee454d1710d88f357df34fdb3f5",
      "channel": "whatsapp",
      "sent": "2025-06-03T13:50:05-00:00",
      "content": {
        "format": "wa_msgobject_v2",
        "msgobject": {
          "type": "image",
          "image": {
            "link": "MEDIA_URL"
          }
        }
      }
    }
  ]
}

Parameters:

fromThe mobile number of the message sender
toVirtual number the message was received on
messageidIntelliSoftware's allocated message id
channelMessage channel ('whatsapp')
sentDate and time message was sent (in W3CDTF DateTime Format) Examples: 2010-02-03T13:50:05-00:00 = 3rd February 2010 13:50:05 GMT 2010-06-10T14:45:12+01:00 = 10th June 2010 14:45:12 BST
formatFormat of WhatsApp Message Object. Latest version is 'wa_msgobject_v2'
msgobjectWhatsApp Message Object (Version 2.0)
Message Type:   
text=Message+Text&msgid=10011000000000000001&networkcode=234010&sent=2025-06-03T13%3a50%3a05-00%3a00

Parameters:

textThe content of the text message
msgidIntelliSoftware's allocated message id
networkcodeThe sender's home network. This parameter is only available for messages received on shortcodes. See Network Code table below for values.
sentDate and time message was sent (in W3CDTF DateTime Format) Examples: 2010-02-03T13:50:05-00:00 = 3rd February 2010 13:50:05 GMT 2010-06-10T14:45:12+01:00 = 10th June 2010 14:45:12 BST 
text=Message+Text&msgid=10011000000000000001&networkcode=234010&sent=2025-06-03T13%3a50%3a05-00%3a00

Parameters:

textThe content of the text message
msgidIntelliSoftware's allocated message id
networkcodeThe sender's home network. This parameter is only available for messages received on shortcodes. See Network Code table below for values.
sentDate and time message was sent (in W3CDTF DateTime Format) Examples: 2010-02-03T13:50:05-00:00 = 3rd February 2010 13:50:05 GMT 2010-06-10T14:45:12+01:00 = 10th June 2010 14:45:12 BST 
text=Message+Text&msgid=10011000000000000001&networkcode=234010&sent=2025-06-03T13%3a50%3a05-00%3a00

Parameters:

textThe content of the text message
msgidIntelliSoftware's allocated message id
networkcodeThe sender's home network. This parameter is only available for messages received on shortcodes. See Network Code table below for values.
sentDate and time message was sent (in W3CDTF DateTime Format) Examples: 2010-02-03T13:50:05-00:00 = 3rd February 2010 13:50:05 GMT 2010-06-10T14:45:12+01:00 = 10th June 2010 14:45:12 BST

HTTP Response:

Our server expects a HTTP 200 (OK) status. Any content returned by your server will be ignored.

If anything other than a status 200 is returned then our server will consider this an error. On an error condition our server will retry to delivery the same message every 5 minute until the error is resolved.