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

Parameters:

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

Parameters:

fromThe mobile number of the message sender
toVirtual number the message was received on
msgtypeMessage Type
udUser Data
messageidIntelliSoftware's allocated message id
channelMessage channel
sentDate and time message was sent (in W3CDTF DateTime Format) Examples: 2010-02-03T13:50:05-00:00 = 3rd Feburary 2010 13:50:05 GMT 2010-06-10T14:45:12+01:00 = 10th June 2010 14:45:12 BST 
{
  "messages": [
    {
      "to": "44771012346",
      "from": "44771012345",
      "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
msgtypeMessage Type
msgobjectWhatsApp Message Object (Version 2.0)
messageidIntelliSoftware's allocated message id
channelMessage channel
sentDate and time message was sent (in W3CDTF DateTime Format) Examples: 2010-02-03T13:50:05-00:00 = 3rd Feburary 2010 13:50:05 GMT 2010-06-10T14:45:12+01:00 = 10th June 2010 14:45:12 BST 
{
  "messages": [
    {
      "to": "44771012346",
      "from": "44771012345",
      "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
msgtypeMessage Type
msgobjectWhatsApp Message Object (Version 2.0)
messageidIntelliSoftware's allocated message id
channelMessage channel
sentDate and time message was sent (in W3CDTF DateTime Format) Examples: 2010-02-03T13:50:05-00:00 = 3rd Feburary 2010 13:50:05 GMT 2010-06-10T14:45:12+01:00 = 10th June 2010 14:45:12 BST 
{
  "messages": [
    {
      "to": "44771012346",
      "from": "44771012345",
      "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
msgtypeMessage Type
msgobjectWhatsApp Message Object (Version 2.0)
messageidIntelliSoftware's allocated message id
channelMessage channel
sentDate and time message was sent (in W3CDTF DateTime Format) Examples: 2010-02-03T13:50:05-00:00 = 3rd Feburary 2010 13:50:05 GMT 2010-06-10T14:45:12+01:00 = 10th June 2010 14:45:12 BST 
{
  "messages": [
    {
      "to": "44771012346",
      "from": "44771012345",
      "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
msgtypeMessage Type
msgobjectWhatsApp Message Object (Version 2.0)
messageidIntelliSoftware's allocated message id
channelMessage channel
sentDate and time message was sent (in W3CDTF DateTime Format) Examples: 2010-02-03T13:50:05-00:00 = 3rd Feburary 2010 13:50:05 GMT 2010-06-10T14:45:12+01:00 = 10th June 2010 14:45:12 BST
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 Feburary 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 Feburary 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 Feburary 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.