HTTP > Overview

    Overview(Last Updated : 01/11/2017)

    Add messaging and contact collection to your system with just HTML.

    Enhance your applications or services with our messaging and customer database features through our HTTP API. With our feature-rich, two-way API, you can send messages through SMS, voice, and email to a single contact or to an entire distribution list. You can even manage the contacts and your mobile keywords programmatically.

    • This updated version is an asynchronous, non-blocking API, which can process multiple calls simultaneously.
    • Updates are sent back with tracking IDs until the system is done processing, at which point results are sent as a response.

    Making a Resource Call

    Each function is called by identifying the relevant uniform resource identifier (URI) and the POST method. Then, you can set the parameters and their unique values.

    To demonstrate how our HTTP API works, let’s take a look at how to add an individual subscription, or contact, to your database. First, you would send the following resource (Adding a Contact) request URI using the POST method:

    Request Example

    GET Method

    POST Method

    <form method="post" action=""> <input type="text" name="apikey" value="1234567890"> <input type="text" name="first_name" value="firstname"> <input type="text" name="last_name" value="lastname"> <input type="text" name="email" value=""> <input type="text" name="country_code" value="1"> <input type="text" name="mobile_number" value="1234567890"> <input type="text" name="list_name" value="listname"> <input type="text" name="send_verification" value="TRUE"> <input type="text" name="allow_access_info" value="TRUE"> <input type="text" name="custom_verification_msg" value="custom verify message"> </form>

    Response Example

    The following response will be sent back upon receipt of the API user's request to show that the request had been received and to uniquely identify the request for future reference.

    { "requestID":"1234561234567asdf123" }

    You can use this requestID to look up the status and results of your API request using the Check Response function.

    Ready, Set, Go!

    Now that you’ve had a taste of what our HTTP API is like and what it can do, go here to see the full list of coding parameters and examples.