Account » Setting

Update your account settings.

Base URL

All requests to TheTexting must be submitted to the base URL. TheTexting provides you with an option of a response as a JSON object, or an XML string - you get to choose which response by selecting the appropriate base URL for your request.

JSON end point

XML end point

HTTP Methods

All requests are submitted through the HTTP POST or GET method using UTF-8 encoding and URL encoded values.

Expected "Content-Type" for POST is "application/x-www-form-urlencoded", however we also support "application/json", "application/jsonrequest", "application/x-javascript", "text/json", "text/javascript", "text/x-javascript", "text/x-json" when posting parameters as a JSON object.


All requests require your API credentials (api_key & api_secret), which you can find under "API Settings" in TheTexting Dashboard.

Parameter Description
api_key Required. Your API Key. Ex: api_key=2f0ihf5656lfu03jl
api_secret Required. Your API Secret. Ex: api_secret=cluol3434qwfc0lg
new_secret_key Optional. Your new API secret key.
new_in_callback_url_type Optional. Either 'HTTP' or 'HTTPS'.
new_in_callback_url Optional. Inbound call back URL without application protocol for e.g.
new_dr_callback_url_type Optional. Either 'HTTP' or 'HTTTPS'.
new_dr_callback_url Optional. Delivery call back URL without application protocol for e.g.

Sample URL (POST)

JSON Response (Success)


    "Response": {

        "secret_key": "321",

        "in_callback_url_type": "HTTP",


        "dr_callback_url_type": "HTTP",



    "ErrorMessage": "",

    "Status": 0


XML Response (Success)

<TheTexting xmlns:i="">
<Response xmlns:d2p1="">

JSON Response (Failure)

"Response": null,
"ErrorMessage": "Parameters Missing",
"Status": 2

XML Response (Failure)

<TheTexting xmlns:i="">
<ErrorMessage>Parameters Missing</ErrorMessage>
<Response i:nil="true"/>

Respond Codes

Code Meaning
0 Request is successful
1 Request has failed.
2 Parameters are missing.
3 Credentials are invalid.
4 Parameters are invalid.
5 Result has returned empty.
6 Status is invalid.

Callback Response

If you have set Incoming Reply callback URL under settings or with the number, we will send you the following parameters.

Sample URL

https://YOURCALLBACKURL.COM/YOURPAGE?from=123456&to=1556985&text=This is a test message.&datetime=Jun 9 2017 09:41 AM&cost=0.00

Parameter Description
From Sender number of this message.
To Receiver number of this message.
Text Text of the incoming message received.
Date-time Date & Time when this message was received.
cost Cost of the message if any.