In order to use the SUMOTEXT API to send an MT, your server's IP Address and your SUMOTEXT API Key must be registered in the SUMOTEXT API Database and tied to a specific account and dedicated short code. All clients can send messages from inside our online campaign management tools. However, if you have a dedicated short code, you are free to send messages from your own internal system via this API.

When you want to send an MT text message from your own system, SUMOTEXT will provide a dedicated HTTPS URL. Use HTTP GET with 6 query string parameters. Parameter names are case sensitive and all lower case.

https://api.sumotext.com/api/sumopost/post	

All parameter and key names are case sensitive, use all lower case for all key names

xml

<?xml version="1.0"?>
<smoMt>
    <apikey>[apikey]</apikey>
    <shortcode>[short code]</shortcode>
    <key>[keyword]</key>
    <mobile>[mobile number]</mobile>
    <carrier>[carrier code]</carrier>
    <msg>[This is where the message goes]</msg>
</smoMt>

json

{
    "apikey":"[apikey]",
    "shortcode":"[shotcode]",
    "key":"key",
    "mobile":"[mobile number]",
    "carrier":"[carrier code]",
    "msg":"[This is where the message goes ]"
}

querystring

?apikey=[apikey]&mobile=[mobile number]&carrier=[carrier code]&shortcode=[shortcode]&key=[key]&msg=[This is where the message goes]

Each post will return the SUMOTEXT ID for that MT and an Error Object.

json

{
    "sumoId":"8CB2C254-90DD-45C3-A60F-0FA55D1B9C40",
    "Err":
        {
            "ErrNum":0,
            "ErrMessage":""
        }
}

xml

<smoPostReturn xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SumotextApi">
    <sumoId>8CE1AB33-5484-4270-B646-B235A28C7483</sumoId>
        <Err>			
            <ErrNum>0</ErrNum>
            <ErrMessage></ErrMessage>
        </Err>
</smoPostReturn>

The Error object will report No Error when a post is successful. The Following Errors are currently coded for, others may be added