Before You Start

Welcome to the Tatango API! The Tatango API is designed for developers, engineers, or anyone else who's comfortable creating custom-coded solutions or integrating with RESTful APIS. If you're not familiar with API concepts like HTTP response codes, REST endpoints, and JSON, try Zapier.

You can view code examples in the dark area to the right, and you can switch the programming language of the examples with the tabs in the top right.

Rate Limits

The Tatango API allows 1200 calls per hour or 1 call every 3 seconds. Please contact your account manager with your specific use case if you need a bump to this limit.

Returning multiple results and pagination

By default, GET API calls that return multiple items in a list will return up to 10 items for a single call. The "pages_count" parameter in the returned JSON will indicate the number of "pages" included in the entire result set. (So for example, if a call to https://app.tatango.com/api/v2/lists finds 27 lists in the system, the JSON will include the following (see JSON snippet to the right):

   "per_page":10,
   "count":27,
   "page":1,
   "pages_count":3

Note that the "pages_count" parameter will default to 0 when there is no items in the list.

To fetch the next page of results, pass the "page" parameter on the URL, like this: https://app.tatango.com/api/v2/lists?page=2. You can also change the number of records returned in each "page" by passing in a "per_page" parameter as part of the URL, like this: https://app.tatango.com/api/v2/lists?per_page=50. Note that the system will only allow up to 1000 records to be returned in a single call.

Authentication

Note: You can access your API key here.

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/example-endpoint')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Get.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
response = http.request(request)

# With shell, you can just pass the correct email and api key with each request
curl -u emailaddress@mydomain.com:my_api_key https://app.tatango.com/api/v2/example-endpoint

var request = new XMLHttpRequest();
request.open("POST", "https://app.tatango.com/api/v2/example-endpoint", false);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
request.send(null);

Tatango authenticates API requests by validating an API key that must be passed with each API call. We use the built-in HTTP basic authentication scheme supported by most HTTP libraries. Use your login email as the username and the API key as the password.

Accounts

Get Current Account

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/accounts')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Get.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
response = http.request(request)

curl "https://app.tatango.com/api/v2/accounts/me" -X GET \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open("GET", "https://app.tatango.com/api/v2/accounts/me", false);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
request.send(null);

{
  "status": "OK",
  "account": {
    "id": 37,
    "email": "myemail36@gmail.com",
    "username": "boowebb36"
  }
}

This endpoint retrieves the current account, as specified by the API key used to authenticate.

HTTP Request

GET https://app.tatango.com/api/v2/accounts/me

Lists

Note: the following settings cannot be modified via the API:

API Confirmation Resend Block Timeout
Resubscribers

List all Lists

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Get.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists" -X GET \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open("GET", "https://app.tatango.com/api/v2/lists", false);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
request.send(null);

{
  "status": "OK",
  "per_page": 10,
  "count": 3,
  "page": 1,
  "pages_count": 1,
  "lists": [
    {
      "id": 7,
      "name": "Mobile Campaign",
      "email_digest": "myemail12@gmail.com",
      "email_subscribe": null,
      "email_unsubscribe": null,
      "first_optin_message": "",
      "second_optin_message": "",
      "message_help": null,
      "message_stop": null,
      "message_reply": null,
      "message_already_subscribed": null,
      "message_yes": null,
      "keyword_names": [],
      "counts": {
        "subscribers": 0,
        "unsubscribed": 0,
        "cleaned": 0
      },
      "opt_in_type": "single",
      "opt_in_requests": []
    },
    {
      "id": 8,
      "name": "Pizza Campaign",
      "email_digest": "myemail14@gmail.com",
      "email_subscribe": null,
      "email_unsubscribe": null,
      "first_optin_message": "",
      "second_optin_message": "",
      "message_help": null,
      "message_stop": null,
      "message_reply": null,
      "message_already_subscribed": null,
      "message_yes": null,
      "keyword_names": [],
      "counts": {
        "subscribers": 0,
        "unsubscribed": 0,
        "cleaned": 0
      },
      "opt_in_type": "single",
      "opt_in_requests": []
    },
    {
      "id": 9,
      "name": "Pizza Campaign",
      "email_digest": "myemail15@gmail.com",
      "email_subscribe": null,
      "email_unsubscribe": null,
      "first_optin_message": "",
      "second_optin_message": "",
      "message_help": null,
      "message_stop": null,
      "message_reply": null,
      "message_already_subscribed": null,
      "message_yes": null,
      "keyword_names": ["NEWHOTELS"],
      "counts": {
        "subscribers": 0,
        "unsubscribed": 0,
        "cleaned": 0
      },
      "opt_in_type": "single",
      "opt_in_requests": []
    }
  ]
}

This endpoint retrieves a list of all lists owned by the current account.

HTTP Request

GET https://app.tatango.com/api/v2/lists

Retrieve List

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/<ID>')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Get.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/<ID>" -X GET \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open("GET", "https://app.tatango.com/api/v2/lists/<ID>", false);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
request.send(null);

{
  "status": "OK",
  "list": {
    "id": 2,
    "name": "Book Campaign",
    "email_digest": "myemail2@gmail.com",
    "email_subscribe": null,
    "email_unsubscribe": null,
    "first_optin_message": "",
    "second_optin_message": "",
    "message_help": null,
    "message_stop": null,
    "message_reply": null,
    "message_already_subscribed": null,
    "message_yes": null,
    "keyword_names": [],
    "counts": {
      "subscribers": 0,
      "unsubscribed": 0,
      "cleaned": 0
    },
    "opt_in_type": "single",
    "opt_in_requests": []
  }
}

This endpoint retrieves a specific list.

HTTP Request

GET https://app.tatango.com/api/v2/lists/<ID>

URL Parameters

Parameter	Description
ID	The ID of the list to retrieve

Configure List Opt-In Type

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/<ID>/opt_in_settings')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Put.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
request.body({"opt_in_type":"double","opt_in_requests":[{"collected_data":"zip_code","request_message":"Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","retry_message":"Incorrect zip code. Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","follow_up":true,"follow_up_hour":2,"no_response_message":"Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","opt_in_message":null,"second_opt_in_message":null,"success_action":"nextrequest"},{"collected_data":"email_address","request_message":"Thank you! Reply with email address for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","retry_message":"Incorrect email. Reply with email address for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","follow_up":true,"follow_up_hour":24,"no_response_message":"Reply with email address for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","opt_in_message":null,"second_opt_in_message":null,"success_action":"nextrequest"},{"collected_data":"first_name","request_message":"Thank you! Reply with first name for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","retry_message":"Incorrect name. Reply with your first name for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","follow_up":true,"follow_up_hour":24,"no_response_message":"Reply with your first name for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","opt_in_message":null,"second_opt_in_message":null,"success_action":"nextrequest"},{"collected_data":"yes","request_message":"Thank you! Reply YES for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","retry_message":"Response not understood. Reply YES for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","follow_up":false,"follow_up_hour":null,"opt_in_message":"ACME Retail: You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com","second_opt_in_message":"ACME Retail: Welcome back! You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com","opt_in_message":"ACME Retail: You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com","second_opt_in_message":"ACME Retail: Welcome back! You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com","success_action":"optinsubscriber"}]})
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/<ID>/opt_in_settings" -d '{"opt_in_type":"double","opt_in_requests":[{"collected_data":"zip_code","request_message":"Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","retry_message":"Incorrect zip code. Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","follow_up":true,"follow_up_hour":2,"no_response_message":"Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","opt_in_message":null,"second_opt_in_message":null,"success_action":"nextrequest"},{"collected_data":"email_address","request_message":"Thank you! Reply with email address for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","retry_message":"Incorrect email. Reply with email address for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","follow_up":true,"follow_up_hour":24,"no_response_message":"Reply with email address for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","opt_in_message":null,"second_opt_in_message":null,"success_action":"nextrequest"},{"collected_data":"first_name","request_message":"Thank you! Reply with first name for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","retry_message":"Incorrect name. Reply with your first name for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","follow_up":true,"follow_up_hour":24,"no_response_message":"Reply with your first name for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","opt_in_message":null,"second_opt_in_message":null,"success_action":"nextrequest"},{"collected_data":"yes","request_message":"Thank you! Reply YES for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","retry_message":"Response not understood. Reply YES for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","follow_up":false,"follow_up_hour":null,"opt_in_message":"ACME Retail: You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com","second_opt_in_message":"ACME Retail: Welcome back! You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com","opt_in_message":"ACME Retail: You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com","second_opt_in_message":"ACME Retail: Welcome back! You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com","success_action":"optinsubscriber"}]}' -X PUT \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "PUT",
  "https://app.tatango.com/api/v2/lists/<ID>/opt_in_settings",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
var data = JSON.stringify({
  opt_in_type: "double",
  opt_in_requests: [
    {
      collected_data: "zip_code",
      request_message:
        "Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      retry_message:
        "Incorrect zip code. Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      follow_up: true,
      follow_up_hour: 2,
      no_response_message:
        "Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      opt_in_message: null,
      second_opt_in_message: null,
      success_action: "nextrequest",
    },
    {
      collected_data: "email_address",
      request_message:
        "Thank you! Reply with email address for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      retry_message:
        "Incorrect email. Reply with email address for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      follow_up: true,
      follow_up_hour: 24,
      no_response_message:
        "Reply with email address for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      opt_in_message: null,
      second_opt_in_message: null,
      success_action: "nextrequest",
    },
    {
      collected_data: "first_name",
      request_message:
        "Thank you! Reply with first name for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      retry_message:
        "Incorrect name. Reply with your first name for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      follow_up: true,
      follow_up_hour: 24,
      no_response_message:
        "Reply with your first name for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      opt_in_message: null,
      second_opt_in_message: null,
      success_action: "nextrequest",
    },
    {
      collected_data: "yes",
      request_message:
        "Thank you! Reply YES for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      retry_message:
        "Response not understood. Reply YES for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      follow_up: false,
      follow_up_hour: null,
      opt_in_message:
        "ACME Retail: You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com",
      second_opt_in_message:
        "ACME Retail: Welcome back! You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com",
      opt_in_message:
        "ACME Retail: You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com",
      second_opt_in_message:
        "ACME Retail: Welcome back! You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com",
      success_action: "optinsubscriber",
    },
  ],
});
request.send(data);

{
  "status": "Opt in settings updated",
  "opt_in_type": "double",
  "opt_in_requests": [
    {
      "bypass_opt_in_response": false,
      "collected_data": "zip_code",
      "created_at": "2016-09-07T14:10:41-07:00",
      "follow_up": true,
      "follow_up_hour": 2,
      "id": 1,
      "list_id": 10,
      "no_response_message": "Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      "opt_in_message": null,
      "request_message": "Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      "retry_message": "Incorrect zip code. Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      "second_opt_in_message": null,
      "success_action": "nextrequest",
      "updated_at": "2016-09-07T14:10:41-07:00"
    },
    {
      "bypass_opt_in_response": false,
      "collected_data": "email_address",
      "created_at": "2016-09-07T14:10:41-07:00",
      "follow_up": true,
      "follow_up_hour": 2,
      "id": 2,
      "list_id": 10,
      "no_response_message": "Reply with email address for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      "opt_in_message": null,
      "request_message": "Thank you! Reply with email address for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      "retry_message": "Incorrect email. Reply with email address for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      "second_opt_in_message": null,
      "success_action": "nextrequest",
      "updated_at": "2016-09-07T14:10:41-07:00"
    },
    {
      "bypass_opt_in_response": false,
      "collected_data": "first_name",
      "created_at": "2016-09-07T14:10:41-07:00",
      "follow_up": true,
      "follow_up_hour": 2,
      "id": 3,
      "list_id": 10,
      "no_response_message": "Reply with your first name for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      "opt_in_message": null,
      "request_message": "Thank you! Reply with first name for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      "retry_message": "Incorrect name. Reply with your first name for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      "second_opt_in_message": null,
      "success_action": "nextrequest",
      "updated_at": "2016-09-07T14:10:41-07:00"
    },
    {
      "bypass_opt_in_response": false,
      "collected_data": "yes",
      "created_at": "2016-09-07T14:10:41-07:00",
      "follow_up": true,
      "follow_up_hour": 2,
      "id": 4,
      "list_id": 10,
      "no_response_message": null,
      "opt_in_message": "ACME Retail: You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com",
      "request_message": "Thank you! Reply YES for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      "retry_message": "Response not understood. Reply YES for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      "second_opt_in_message": "ACME Retail: Welcome back! You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com",
      "success_action": "optinsubscriber",
      "updated_at": "2016-09-07T14:10:41-07:00"
    }
  ]
}

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/<ID>/opt_in_settings')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Put.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
request.body({"opt_in_type":"double","opt_in_requests":[{"collected_data":"zip_code","request_message":"Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","retry_message":"Incorrect zip code. Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","follow_up":true,"follow_up_hour":2,"no_response_message":"Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","success_action":null}]})
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/<ID>/opt_in_settings" -d '{"opt_in_type":"double","opt_in_requests":[{"collected_data":"zip_code","request_message":"Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","retry_message":"Incorrect zip code. Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","follow_up":true,"follow_up_hour":2,"no_response_message":"Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","success_action":null}]}' -X PUT \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "PUT",
  "https://app.tatango.com/api/v2/lists/<ID>/opt_in_settings",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
var data = JSON.stringify({
  opt_in_type: "double",
  opt_in_requests: [
    {
      collected_data: "zip_code",
      request_message:
        "Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      retry_message:
        "Incorrect zip code. Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      follow_up: true,
      follow_up_hour: 2,
      no_response_message:
        "Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      success_action: null,
    },
  ],
});
request.send(data);

{
  "status": "Opt in settings updated",
  "opt_in_type": "double",
  "opt_in_requests": [
    {
      "bypass_opt_in_response": false,
      "collected_data": "zip_code",
      "created_at": "2016-09-07T14:10:41-07:00",
      "follow_up": true,
      "follow_up_hour": 2,
      "id": 1,
      "list_id": 10,
      "no_response_message": "Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      "opt_in_message": null,
      "request_message": "Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      "retry_message": "Incorrect zip code. Reply with zip code for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
      "second_opt_in_message": null,
      "success_action": null,
      "updated_at": "2016-09-07T14:10:41-07:00"
    }
  ]
}

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/<ID>/opt_in_settings')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Put.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
request.body({"opt_in_type":"single","first_optin_message":"ACME Retail: You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com","second_optin_message":"ACME Retail: Welcome back! You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com"})
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/<ID>/opt_in_settings" -d '{"opt_in_type":"single","first_optin_message":"ACME Retail: You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com","second_optin_message":"ACME Retail: Welcome back! You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com"}' -X PUT \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "PUT",
  "https://app.tatango.com/api/v2/lists/<ID>/opt_in_settings",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
var data = JSON.stringify({
  opt_in_type: "single",
  first_optin_message:
    "ACME Retail: You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com",
  second_optin_message:
    "ACME Retail: Welcome back! You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com",
});
request.send(data);

{
  "opt_in_type": "single",
  "first_optin_message": "ACME Retail: You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com",
  "second_optin_message": "ACME Retail: Welcome back! You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com"
}

This endpoint configures an opt-in type for a list.

HTTP Request

PUT https://app.tatango.com/api/v2/lists/<ID>/opt_in_settings

URL Parameters

Parameter	Description
ID	The ID of the list to change

JSON Parameters (JSON Object)

Parameter	Description
bypass_opt_in_response	If this is set to true, then the usual "first_optin_message" or "second_optin_message" that Tatango sends when someone completes the opt-in process for a list, is not sent. Customers may use this functionality if they prefer to use a scheduled after opt-in message to welcome subscribers, rather than the "first_optin_message" or "second_optin_message".
opt_in_type	Opt in type (may be either "single" or "double") "single" - This opt-in type is used when you want the user to subscribe to a designated list by simply texting your opt-in keyword to your short code. "double" - This opt-in type is used when you want the user to provide you additional information such as email, name, zip codes, etc., after texting your opt-in keyword to your short code, but before subscribing them to a designated list.
first_optin_message	This message is sent to a phone number after they've succesfully completed the single opt-in process for a specific list, and at no point in the past has been subscribed to the list. (only used with single opt-ins) Example Message: "ACME Retail: You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com
second_optin_message	This message is sent to a phone number after they've succesfully completed the single opt-in process for a specific list, and at some point in the past has been subscribed to the list. This happens when a phone number opts-in, opts-out, then opts-in again. (only used with single opt-ins) Example Message: "ACME Retail: Welcome back! You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com"
opt_in_requests[collected_data]	Array of opt-in requests, which designate the type of information you'd like a phone number to respond to the message [request_message] with. (only used with double opt-ins) "zip_code" "email_address" "first_name" "yes"
opt_in_requests[request_message]	This message is received by a phone number after they text your opt-in keyword, and the opt_in_type is set as "double". It's critical in this message that you ask the user to respond back with whatever information you've set in [collected_data]. Example Message: "ACME Retail: Reply YES for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com"
opt_in_requests[retry_message]	If a phone number's response to the message [request_message] isn't valid, based on the information you're trying to collect based on [collected_data], this is the message that will be sent back in response. Example Message: "Response not understood. Reply YES for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com"
opt_in_requests[follow_up]	If a phone number doesn't respond to [request_message], you have the option of sending a follow up message, which is [no_response_message], to re-request the information you're asking them for. (may be either "true" or "false")
opt_in_requests[follow_up_hour]	If [follow_up] is "true" it's required that you set an amount of hours to have Tatango follow up with a phone number, if they don't respond to the [request_message]. The message that is sent to follow up, is [no_response_message].
opt_in_requests[no_response_message]	This is the message sent to a phone number that doesn't respond to [request_message] after the amount of hours designated with [follow_up_hour], to re-request the information you're asking them for. (only used if [follow_up] is "true") Example Message: "No response received. Reply YES for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com."
opt_in_requests[success_action]	Use either "nextrequest" or "optinsubscriber". "nextrequest" - This option allows you to collect additional information from a user, before subscribing them to a designated list. "optinsubscriber" - This option ends the opt-in process, and subscribes the user to a designated list. (Required on last opt-in request)
opt_in_requests[opt_in_message]	This message is sent to a phone number after they've succesfully completed the double opt-in process for a specific list, and at no point in the past has been subscribed to the list. (only used with double opt-ins) Example Message: "ACME Retail: You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com"
opt_in_requests[second_opt_in_message]	This message is sent to a phone number after they've succesfully completed the double opt-in process for a specific list, and at some point in the past has been subscribed to the list. This happens when a phone number opts-in, opts-out, then opts-in again. (only used with double opt-ins) Example Message: "ACME Retail: Welcome back! You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com"

Creating a New List

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Post.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
request.body({"list":{"name":"My awesome list","message_yes":"ACME Retail: Reply YES for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","message_help":"ACME Retail: Recurring SMS/MMS msgs. Text STOP 2 end. Msg&data rates may apply. Terms apply 12345-info.com. Msging help: help@12345-info.com","message_stop":"ACME Retail: You have been unsubscribed and will not receive any more messages.","message_reply":"ACME Retail: Thank you for your response. Reply STOP to end, HELP for help. Msg&data rates may apply. Terms apply 12345-info.com","message_already_subscribed":"ACME Retail: You already agreed to recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com","first_optin_message":"ACME Retail: You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com","second_optin_message":"ACME Retail: Welcome back! You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com","email_digest":"myemail18@gmail.com","email_subscribe":true,"email_unsubscribe":true}})
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/" -d '{"list":{"name":"My awesome list","message_yes":"ACME Retail: Reply YES for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com","message_help":"ACME Retail: Recurring SMS/MMS msgs. Text STOP 2 end. Msg&data rates may apply. Terms apply 12345-info.com. Msging help: help@12345-info.com","message_stop":"ACME Retail: You have been unsubscribed and will not receive any more messages.","message_reply":"ACME Retail: Thank you for your response. Reply STOP to end, HELP for help. Msg&data rates may apply. Terms apply 12345-info.com","message_already_subscribed":"ACME Retail: You already agreed to recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com","first_optin_message":"ACME Retail: You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com","second_optin_message":"ACME Retail: Welcome back! You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com","email_digest":"myemail18@gmail.com","email_subscribe":true,"email_unsubscribe":true}}' -X POST \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open("POST", "https://app.tatango.com/api/v2/lists/", false);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
var data = JSON.stringify({
  list: {
    name: "My awesome list",
    message_yes:
      "ACME Retail: Reply YES for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
    message_help:
      "ACME Retail: Recurring SMS/MMS msgs. Text STOP 2 end. Msg&data rates may apply. Terms apply 12345-info.com. Msging help: help@12345-info.com",
    message_stop:
      "ACME Retail: You have been unsubscribed and will not receive any more messages.",
    message_reply:
      "ACME Retail: Thank you for your response. Reply STOP to end, HELP for help. Msg&data rates may apply. Terms apply 12345-info.com",
    message_already_subscribed:
      "ACME Retail: You already agreed to recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com",
    first_optin_message:
      "ACME Retail: You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com",
    second_optin_message:
      "ACME Retail: Welcome back! You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com",
    email_digest: "myemail18@gmail.com",
    email_subscribe: true,
    email_unsubscribe: true,
  },
});
request.send(data);

{
  "status": "List created",
  "list": {
    "id": 11,
    "name": "My awesome list",
    "email_digest": "myemail18@gmail.com",
    "email_subscribe": true,
    "email_unsubscribe": true,
    "first_optin_message": "ACME Retail: You already agreed to recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg & data rates may apply. Terms apply 12345-info.com",
    "second_optin_message": "ACME Retail: Welcome back! You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com",
    "message_help": "ACME Retail: Recurring SMS/MMS msgs. Text STOP 2 end. Msg&data rates may apply. Terms apply 12345-info.com. Msging help: help@12345-info.com",
    "message_stop": "ACME Retail: You have been unsubscribed and will not receive any more messages.",
    "message_reply": "ACME Retail: Thank you for your response. Reply STOP to end, HELP for help. Msg&data rates may apply. Terms apply 12345-info.com",
    "message_already_subscribed": "ACME Retail: Reply YES for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com",
    "message_yes": "ACME Retail: Recurring SMS/MMS msgs. Text STOP 2 end. Msg&data rates may apply. Terms apply 12345-info.com. Msging help: help@12345-info.com",
    "keyword_names": ["JOIN", "SAVE", "COUPONS", "SALE"],
    "counts": {
      "subscribers": 0,
      "unsubscribed": 0,
      "cleaned": 0
    },
    "opt_in_type": "single",
    "opt_in_requests": []
  }
}

This endpoint creates a new list.

Note: the following settings cannot be modified via the API:

API Confirmation Resend Block Timeout
Resubscribers

HTTP Request

POST https://app.tatango.com/api/v2/lists/

JSON Parameters (JSON Object)

Parameter	Description
list[name]	List names are to help you distinguish which list is which, and are only visible to you, and are never seen by users. (Limit 25 characters)
list[message_yes]	This message is sent to a user when their mobile number is added to a list through the API. Users must respond “YES” or “Y” to this message, to be subscribed. Example Message: "ACME Retail: Reply YES for recurring autodialed SMS/MMS marketing msgs. No purchase rqd. Msg&data rates may apply. Terms apply 12345-info.com"
list[message_help]	This is the message that is sent back to users when they respond to any of your messages with the word "HELP". Example Message: ACME Retail: Recurring SMS/MMS msgs. Text STOP 2 end. Msg&data rates may apply. Terms apply 12345-info.com. Msging help: help@12345-info.com"
list[message_stop]	This is the message that is sent back to users when they respond to any of your messages with the word "STOP". Example Message: "ACME Retail: You have been unsubscribed and will not receive any more messages."
list[message_reply]	This is the message that is sent back to subscribers when they respond to a mass message that you send them. Example Message: "ACME Retail: Thank you for your response. Reply STOP to end, HELP for help. Msg&data rates may apply. Terms apply 12345-info.com"
list[message_already_subscribed]	This is the message that is sent back to users when they're attempting to opt-in, but they're already subscribed to the list. Example Message: "ACME Retail: You already agreed to recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com"
list[first_optin_message]	This message is sent to a phone number after they've succesfully completed the opt-in process for a specific list, and at no point in the past has been subscribed to the list. Example Message: "ACME Retail: You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com"
list[second_optin_message]	This message is sent to a phone number after they've succesfully completed the opt-in process for a specific list, and at some point in the past has been subscribed to the list. This happens when a phone number opts-in, opts-out, then opts-in again. Example Message: "ACME Retail: Welcome back! You agreed to receive recurring SMS/MMS msgs. Txt STOP 2 end, HELP 4 help. Msg&data rates may apply. Terms apply 12345-info.com"
list[email_digest]	Receive a daily email with a list of phone numbers that subscribed and unsubscribed from a designated list. Leave blank if you dont want to receive this daily email.
list[email_subscribe]	Receive an email immediately when you get a new subscriber for a designated list. Email contains phone number of new subscriber. Leave blank if you dont want to receive this email.
list[email_unsubscribe]	Receive an email immediately when a subscriber unsubscribes from a designated list. Email contains phone number of lost subscriber. Leave blank if you dont want to receive this email.
list[keyword_names]	(optional) An array of keywords to associate to the list. See the FAQs below for keyword limitations.

FAQs

What are the limitations for a keyword?
- A keyword must contain at least two characters and no more than 15 characters.
- Keywords are not case sensitive. FOO will match foo and FOO and Foo.
- You can't use obscene words. We're not going to spell them out here.
Are keywords case sensitive?
No. The system checks for duplicate keywords by transforming all keywords to uppercase before performing matching algorithms.
What happens if the keyword isn't available?
The response from the API will be a 422 error with the response body looking like this: {"status":"error","error":"invalid keyword names: EXISTINGKW"}
What happens if the keyword isn't available?
Yes. By utilizing this endpoint. The response will either be 200 OK {"status":"OK","keyword_name":"available"} or 200 OK {"status":"OK","keyword_name":"unavailable","error":"Name is in use"}.
Can I add multiple keywords to a list?
Yes. The keyword_names parameter would need to be an array, like this: {"keyword_names":["TEST","KEYWORD","NAMES"]}, of valid, not-already used, keywords.
What is a REPLY Response?
REPLY Response is the response sent to the subscriber if they respond to the message with the word REPLY.

Destroying a List

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Delete.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/ID" -d '' -X DELETE \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open("DELETE", "https://app.tatango.com/api/v2/lists/", false);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
var data = JSON.stringify({ list: { name: "My awesome list" } });
request.send(data);

{
  "status": "List Destroyed"
}

This endpoint destroys a list.

HTTP Request

DELETE https://app.tatango.com/api/v2/lists/ID

URL Parameters

Parameter	Description
ID	ID of the list to delete

Setting(Updating) Keywords for a List

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/<ID>/keywords')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Put.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
request.body({"keyword_names":["TEST","KEYWORD","NAMES"]}
)
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/<ID>/keywords" -d '{"keyword_names":["TEST","KEYWORD","NAMES"]}' -X PUT \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "PUT",
  "https://app.tatango.com/api/v2/lists/<ID>/opt_in_settings",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
var data = JSON.stringify({ keyword_names: ["TEST", "KEYWORD", "NAMES"] });
request.send(data);

{
  "status": "Keywords changed",
  "keyword_names": ["TEST", "KEYWORD", "NAMES"]
}

This endpoint sets or updates keywords for a list.

HTTP Request

PUT https://app.tatango.com/api/v2/lists/<ID>/keywords

URL Parameters

Parameter	Description
ID	The ID of the list to change

JSON Parameters (JSON Object)

Parameter	Description
keyword_names	Array of keyword names

Updating a List

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/ID')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Put.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
request.body({"list":{"name":"Name"}})
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/" -d '{"list":{"name":"Name"}}' -X PUT \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open("PUT", "https://app.tatango.com/api/v2/lists/", false);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
var data = JSON.stringify({ list: { name: "Name" } });
request.send(data);

{
  "status": "OK",
  "list": {
    "id": 1,
    "name": "Name",
    "email_digest": "myemail0@gmail.com",
    "email_subscribe": null,
    "email_unsubscribe": null,
    "first_optin_message": "",
    "second_optin_message": "",
    "message_help": null,
    "message_stop": null,
    "message_reply": null,
    "message_already_subscribed": null,
    "message_yes": null,
    "keyword_names": [],
    "counts": {
      "subscribers": 0,
      "unsubscribed": 0,
      "cleaned": 0
    },
    "opt_in_type": "single",
    "opt_in_requests": []
  }
}

This endpoint updates a list.

Note: the following settings cannot be modified via the API:

API Confirmation Resend Block Timeout
Resubscribers

HTTP Request

PUT https://app.tatango.com/api/v2/lists/ID

URL Parameters

Parameter	Description
ID	The ID of the list to change

JSON Parameters (JSON Object)

Parameter	Description
list[name]	List name
list[message_yes]	API Opt-In Confirmation Request
list[message_help]	HELP Response
list[message_stop]	STOP Response
list[message_reply]	REPLY Response
list[message_already_subscribed]	Already Subscribed Response
list[first_optin_message]	First Opt In Message
list[second_optin_message]	Second Opt In Message
list[email_digest]	Email to send email digest to. Leave blank if you dont want to receive
list[email_subscribe]	Email to send subscribe notifications to. Leave blank if you dont want to receive
list[email_unsubscribe]	Email to send unsubscribe notifications to. Leave blank if you dont want to receive

Subscribers

Adding a Subscriber

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/ID/subscribers')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Post.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
request.body({"subscriber":{"phone_number":"2141234567","first_name":"John","last_name":"Doe","email":"johndoe@domain.com","birthdate":"19780728","zip_code":"52421","gender":"Male","custom_field_key":"custom_value"}});
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/ID/subscribers" -d '{"subscriber":{"phone_number":"2141234567","first_name":"John","last_name":"Doe","email":"johndoe@domain.com","birthdate":"19780728","zip_code":"52421","gender":"Male","custom_field_key":"custom_value"}}' -X POST \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "POST",
  "https://app.tatango.com/api/v2/lists/ID/subscribers",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
var data = JSON.stringify({
  subscriber: {
    phone_number: "2141234567",
    first_name: "John",
    last_name: "Doe",
    email: "johndoe@domain.com",
    birthdate: "19780728",
    zip_code: "52421",
    gender: "Male",
    custom_field_key: "custom_value",
  },
});
request.send(data);

{
   "status":"Subscriber being added to campaign pending confirmation",
   "subscriber":{
      "phone_number":"2141234567",
      "first_name":"John",
      "last_name":"Doe",
      "email":"johndoe@domain.com",
      "birthdate":"19780728",
      "zip_code":"52421",
      "gender":"Male",
      "cleaned_at":null,
      "subscribed_at":"2016-09-07T14:10:53-07:00",
      "opted_out_at":"2016-09-06T16:00:00-07:00",
      "optin_in_progress":true,
      "opt_in_method":"api",
      "keyword_name":null,
      "carrier":77,
      "carrier_name":"Verizon",
      "tags":[
        "shopping",
        "music",
        "malls"
      ],
      "custom_field_key":"custom_value"
   }
}

{
   "status":"Subscriber has been added - no opt-in message was sent due to list settings.",
   "subscriber":{
      "phone_number":"2141234567",
      "first_name":"John",
      "last_name":"Doe",
      "email":"johndoe@domain.com",
      "birthdate":"19780728",
      "zip_code":"52421",
      "gender":"Male",
      "cleaned_at":null,
      "subscribed_at":"2016-09-07T14:10:53-07:00",
      "opted_out_at":"2016-09-06T16:00:00-07:00",
      "optin_in_progress":true,
      "opt_in_method":"api",
      "keyword_name":null,
      "carrier":77,
      "carrier_name":"Verizon",
      "tags":[
        "shopping",
        "music",
        "malls"
      ],
      "custom_field_key":"custom_value"
   }
}

{
   "status":"Subscriber has already been sent opt-in message for this campaign.",
   "subscriber":{
      "phone_number":"2141234567",
      "phone_number":"2141234567",
      "first_name":"John",
      "last_name":"Doe",
      "email":"johndoe@domain.com",
      "birthdate":"19780728",
      "zip_code":"52421",
      "gender":"Male",
      "cleaned_at":null,
      "subscribed_at":"2016-09-07T14:10:53-07:00",
      "opted_out_at":"2016-09-06T16:00:00-07:00",
      "optin_in_progress":true,
      "opt_in_method":"api",
      "keyword_name":null,
      "carrier":77,
      "carrier_name":"Verizon",
      "tags":[
        "shopping",
        "music",
        "malls"
      ],
      "custom_field_key":"custom_value"
   }
}

{
   "status":"Subscriber is already subscribed to this campaign.",
   "subscriber":{
      "phone_number":"2141234567",
      "phone_number":"2141234567",
      "first_name":"John",
      "last_name":"Doe",
      "email":"johndoe@domain.com",
      "birthdate":"19780728",
      "zip_code":"52421",
      "gender":"Male",
      "cleaned_at":null,
      "subscribed_at":"2016-09-07T14:10:53-07:00",
      "opted_out_at":"2016-09-06T16:00:00-07:00",
      "optin_in_progress":true,
      "opt_in_method":"api",
      "keyword_name":null,
      "carrier":77,
      "carrier_name":"Verizon",
      "tags":[
        "shopping",
        "music",
        "malls"
      ],
      "custom_field_key":"custom_value"
   }
}

{
   "status":"Subscriber being added to campaign pending confirmation",
   "subscriber":{
      "phone_number":"2141234567",
      "phone_number":"2141234567",
      "first_name":"John",
      "last_name":"Doe",
      "email":"johndoe@domain.com",
      "birthdate":"19780728",
      "zip_code":"52421",
      "gender":"Male",
      "cleaned_at":null,
      "subscribed_at":"2016-09-07T14:10:53-07:00",
      "opted_out_at":"2016-09-06T16:00:00-07:00",
      "optin_in_progress":true,
      "opt_in_method":"api",
      "keyword_name":null,
      "carrier":77,
      "carrier_name":"Verizon",
      "tags":[
        "shopping",
        "music",
        "malls"
      ],
      "global_carrier_id": "100313",
      "global_carrier_name": "Verizon Wireless",
      "custom_field_key":"custom_value"
   }
}

This endpoint adds a subscriber to a list.

HTTP Request

POST https://app.tatango.com/api/v2/lists/ID/subscribers

URL Parameters

Parameter	Description
ID	ID of the list

JSON Parameters (JSON Object)

Parameter	Description
subscriber[phone_number]	The wireless phone number of the subscriber.
subscriber[first_name]	(optional) First name - char(50)
subscriber[last_name]	(optional) Last name - char(50)
subscriber[email]	(optional) Email - char(50)
subscriber[birthdate]	(optional) Birthdate - int(8)
subscriber[zip_code]	(optional) ZIP code - char(6)
subscriber[gender]	(optional) Gender - char('Male' or 'Female')
subscriber[bypass_opt_in_process]	When true, the phone number will be added to the list without using the double opt-in method. This means numbers will not receive a "Reply YES to subscribe" message. This option does not suppress the message sent immediately after a phone number has been added to a list, confirming their subscription to the list. To disable the double opt-in method, and the message confirming a phone numbers subscription to a list, both subscriber[bypass_opt_in_process] and subscriber[bypass_opt_in_response] will have to be true.
subscriber[bypass_opt_in_response]	When true, suppress the message sent immediately after a phone number has been added to a list, confirming their subscription to the list. This option is independent of subscriber[bypass_opt_in_process].
subscriber[tags]	(optional) List of tags, comma separated, for example: 'vip customer, card holder, daily alerts'
subscriber[custom_field_key]	(optional) Custom data value

Responses Explained

Key	Description
phone_number	The wireless phone number of the subscriber.
cleaned_at	If this subscriber was automatically unsubscribed from a list, then the date and time of that action will be displayed here.
subscribed_at	The data that this subscriber first subscribed to this specific list.
opted_out_at	The data that this subscriber last unsubscribed from this specific list.
opt_in_method	The original opt-in method used by this subscriber to opt-in to this specific list.
keyword_name	If the subscriber opted-in by texting a keyword, that keyword they used will be displayed here.
carrier	The ID of the wireless carrier for this specific subscriber.
carrier_name	The name of the wireless carrier for this specific subscriber.
global_carrier_id	The ID of the global wireless carrier for this specific subscriber.
global_carrier_name	The name of the global wireless carrier for this specific subscriber.

FAQ About This Endpoint

What happens when we use the add subscriber API to add a home phone number (i.e. non-cellular)?
You will receive the message "Bad phone number: landline or unreachable carrier" with the status code 422.
What happens when we use the add subscriber API to add a phone number that is currently unsubscribed from the list?
We will initiate the process of resubscribing the phone number to the list.
What happens when we use the add subscriber API to add a phone number that is already subscribed to the list?
A 200 OK is returned and no changes are made the subscriber.
Can I request something other than a reply of YES to opt-in when opting into an API?
No. The reply is currently configured to YES.
Can I add a subscriber via API with custom data for that subscriber?
Yes. The optional parameters are listed for this API endpoint.
For subscriber fields like name, birthday, etc., are there any limitations on what we can use, like character limit, only certain characters, etc?
Yes. All optional parameters' limitations are noted - see the JSON parameters above.
In what format should phone numbers be sent?
The phone number should be a continuous string of ten digits - with no dashes and no country code (e.g. "2065551111").
If an account has multiple lists, and a phone number has opted-out, or been cleaned from one list, can we use the API to add them to a new list?
Yes - each list is a separate entity.

Getting a Subscriber

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/ID/subscribers/SUBSCRIBER_ID')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Get.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/ID/subscribers/SUBSCRIBER_ID" -d '' -X GET \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "GET",
  "https://app.tatango.com/api/v2/lists/ID/subscribers/SUBSCRIBER_ID",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
request.send(null);

{
  "status": "OK",
  "subscriber": {
    "phone_number": "2141234567",
    "first_name": "John",
    "last_name": "Doe",
    "email": "johndoe@mydomain.com",
    "birthdate": "19780728",
    "zip_code": "5124",
    "gender": "Male",
    "cleaned_at": null,
    "subscribed_at": "2016-09-07T14:10:53-07:00",
    "opted_out_at": null,
    "optin_in_progress": false,
    "opt_in_method": "api",
    "keyword_name": null,
    "carrier": 77,
    "carrier_name": "Verizon",
    "tags": ["shopping", "malls", "deals"],
    "global_carrier_id": "100313",
    "global_carrier_name": "Verizon Wireless",
    "total_messages_received": 121
  }
}

This endpoint returns information about a current subscriber.

HTTP Request

GET https://app.tatango.com/api/v2/lists/ID/subscribers/SUBSCRIBER_ID

URL Parameters

Parameter	Description
ID	ID of the list
SUBSCRIBER_ID	ID of the subscriber (phone number)

Responses Explained

Key	Description
phone_number	The wireless phone number of the subscriber.
cleaned_at	If this subscriber was automatically unsubscribed from a list, then the date and time of that action will be displayed here.
subscribed_at	The data that this subscriber first subscribed to this specific list.
opted_out_at	The data that this subscriber last unsubscribed from this specific list.
opt_in_method	The original opt-in method used by this subscriber to opt-in to this specific list.
keyword_name	If the subscriber opted-in by texting a keyword, that keyword they used will be displayed here.
carrier	The ID of the wireless carrier for this specific subscriber.
carrier_name	The name of the wireless carrier for this specific subscriber.
global_carrier_id	The ID of the global wireless carrier for this specific subscriber.
global_carrier_name	The name of the global wireless carrier for this specific subscriber.
total_messages_received	The total amount of mass messages this specific subscriber has received over their lifetime from this specific list.

Updating a Subscriber

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/ID/subscribers/SUBSCRIBER_ID')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Put.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
request.body({"subscriber":{"first_name":"John","last_name":"Doe"}})
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/ID/subscribers/SUBSCRIBER_ID" -d '{"subscriber":{"first_name":"John","last_name":"Doe"}}' -X PUT \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "PUT",
  "https://app.tatango.com/api/v2/lists/ID/subscribers/SUBSCRIBER_ID",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
var data = JSON.stringify(
  '{"subscriber":{"first_name":"John","last_name":"Doe", "custom_field_key": "custom_value"}}'
);
request.send(data);

{
  "status": "Subscriber has been updated.",
  "subscriber": {
    "phone_number": "2141234567",
    "first_name": "John",
    "last_name": "Doe",
    "email": "",
    "birthdate": "",
    "zip_code": "",
    "gender": null,
    "cleaned_at": null,
    "subscribed_at": "2016-09-07T14:10:54-07:00",
    "opted_out_at": "2016-09-06T16:00:00-07:00",
    "optin_in_progress": true,
    "opt_in_method": "api",
    "keyword_name": null,
    "carrier": 77,
    "carrier_name": "Verizon",
    "tags": [],
    "global_carrier_id": "100313",
    "global_carrier_name": "Verizon Wireless",
    "custom_field_key": "custom_value"
  }
}

This endpoint updates a subscriber.

Responses Explained

Key	Description
phone_number	The wireless phone number of the subscriber.
cleaned_at	If this subscriber was automatically unsubscribed from a list, then the date and time of that action will be displayed here.
subscribed_at	The data that this subscriber first subscribed to this specific list.
opted_out_at	The data that this subscriber last unsubscribed from this specific list.
opt_in_method	The original opt-in method used by this subscriber to opt-in to this specific list.
keyword_name	If the subscriber opted-in by texting a keyword, that keyword they used will be displayed here.
carrier	The ID of the wireless carrier for this specific subscriber.
carrier_name	The name of the wireless carrier for this specific subscriber.
global_carrier_id	The ID of the global wireless carrier for this specific subscriber.
global_carrier_name	The name of the global wireless carrier for this specific subscriber.

HTTP Request

PUT https://app.tatango.com/api/v2/lists/ID/subscribers/SUBSCRIBER_ID

URL Parameters

Parameter	Description
ID	ID of the list
SUBSCRIBER_ID	ID of the subscriber (phone number)

JSON Parameters (JSON Object)

Parameter	Description
ID	ID of the list
subscriber[phone_number]	The wireless phone number of the subscriber.
subscriber[first_name]	(optional) First name - char(50)
subscriber[last_name]	(optional) Last name - char(50)
subscriber[email]	(optional) Email - char(50)
subscriber[birthdate]	(optional) Birthdate - int(6)
subscriber[zip_code]	(optional) ZIP code - char(6)
subscriber[gender]	(optional) Gender - char('Male' or 'Female')
subscriber[tags]	(optional) List of tags, comma separated, for example: 'vip customer, card holder, daily alerts'
subscriber[custom_field_key]	(optional) Custom data value

Adding Multiple Tags to Multiple Subscribers

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/ID/bulk_taggings')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Post.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
request.body({"bulk_tagging": {"phone_numbers":["2145550762","7185550549","2125550838"],"tags":["local_news","sports_news","celebrity_news","weather_news"]}});
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/ID/bulk_taggings" -d '{"bulk_tagging":{"phone_numbers":["2145550762","7185550549","2125550838"],"tags":["local_news","sports_news","celebrity_news","weather_news"]}}' -X POST \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "POST",
  "https://app.tatango.com/api/v2/lists/ID/bulk_taggings",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
var data = JSON.stringify({
  bulk_tagging: {
    phone_numbers: ["2145550762", "7185550549", "2125550838"],
    tags: ["local_news", "sports_news", "celebrity_news", "weather_news"],
  },
});
request.send(data);

{
  "status": "Bulk tagging operation queued successfully.",
  "number_count": 3,
  "tag_count": 4,
  "subscribers_to_update": 3,
  "replace_tags": false,
  "not_subscribed": [
    "list of numbers passed numbers that are not subscribed, this will not display if all numbers are subscribed"
  ],
  "invalid_numbers": [
    "list of passed numbers that are invalid, this will not display if all numbers are valid"
  ]
}

This endpoint applies multiple tags to multiple subscribers

Responses Explained

Key	Description
number_count	The number of phone numbers in your passed phone_numbers list
tag_count	The number of tags in your passed tags list
subscribers_to_update	The number of subscribed members to your list that will be updated with the new tags
replace_tags	If true all the tags for subscribers will be replaced with the new tags. If false it will add the new tags to the old tags
not_subscribed	A list of phone numbers that were passed that are not subscribed to the defined list. If all numbers are subscribed this will not be displayed
invalid_numbers	A list of phone numbers that were passed in that are not valid phone numbers. An invalid number will also consist of landline phones. If all numbers are valid this will not be displayed

HTTP Request

POST https://app.tatango.com/api/v2/lists/ID/bulk_taggings

URL Parameters

Parameter	Description
ID	ID of the list

JSON Parameters (JSON Object)

Parameter	Description
ID	ID of the list
bulk_tagging[phone_numbers]	Array of phone numbers you want to modify. The max length of this array is 1000 values
bulk_tagging[tags]	(optional) Array of tags to add. The max length of this array is 50 values
bulk_tagging[replace_tags]	(optional) Boolean value to replace tags. If it is true it will replace the old tags with the new tags. This value defaults to false if not defined

Other uses

You can also use this endpoint to mass remove tags from subscribers. For example if replace_tags is true and your tags list is empty it will remove all tags from your numbers list

Unsubscribing a Subscriber

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/ID/subscribers/SUBSCRIBER_ID')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Delete.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/ID/subscribers/SUBSCRIBER_ID" -d '' -X DELETE \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "DELETE",
  "https://app.tatango.com/api/v2/lists/ID/subscribers/SUBSCRIBER_ID",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
request.send(null);

{
  "status": "successfully unsubscribed",
  "subscriber": {
    "phone_number": "2141234567",
    "first_name": "",
    "last_name": "",
    "email": "",
    "birthdate": "",
    "zip_code": "",
    "gender": null,
    "cleaned_at": null,
    "subscribed_at": "2016-09-07T14:10:53-07:00",
    "opted_out_at": "2016-09-07T14:10:54-07:00",
    "optin_in_progress": true,
    "opt_in_method": "api",
    "keyword_name": null,
    "carrier": 77,
    "carrier_name": "Verizon",
    "tags": [],
    "global_carrier_id": "100313",
    "global_carrier_name": "Verizon Wireless"
  }
}

This endpoint unsubscribes a subscriber.

HTTP Request

DELETE https://app.tatango.com/api/v2/lists/ID/subscribers/SUBSCRIBER_ID

URL Parameters

Parameter	Description
ID	ID of the list
SUBSCRIBER_ID	ID of the subscriber (phone number)

Responses Explained

Key	Description
phone_number	The wireless phone number of the subscriber.
cleaned_at	If this subscriber was automatically unsubscribed from a list, then the date and time of that action will be displayed here.
subscribed_at	The data that this subscriber first subscribed to this specific list.
opted_out_at	The data that this subscriber last unsubscribed from this specific list.
opt_in_method	The original opt-in method used by this subscriber to opt-in to this specific list.
keyword_name	If the subscriber opted-in by texting a keyword, that keyword they used will be displayed here.
carrier	The ID of the wireless carrier for this specific subscriber.
carrier_name	The name of the wireless carrier for this specific subscriber.
global_carrier_id	The ID of the global wireless carrier for this specific subscriber.
global_carrier_name	The name of the global wireless carrier for this specific subscriber.

Get a List of Subscribed Phone Numbers

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/ID/subscribers')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Get.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/ID/subscribers" -d '' -X GET \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "GET",
  "https://app.tatango.com/api/v2/lists/ID/subscribers",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
request.send(null);

{
  "status": "OK",
  "per_page": 10,
  "count": 1,
  "page": 1,
  "pages_count": 1,
  "phone_numbers": ["2145550816"]
}

This endpoint gets a list of subscribed phone numbers for the requested list.

HTTP Request

GET https://app.tatango.com/api/v2/lists/ID/subscribers

URL Parameters

Parameter	Description
ID	ID of the list

Get a List of Unsubscribed Phone Numbers

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/ID/subscribers/unsubscribed')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Get.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/ID/subscribers/unsubscribed" -d '' -X GET \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "GET",
  "https://app.tatango.com/api/v2/lists/ID/subscribers/unsubscribed",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
request.send(null);

{
  "status": "OK",
  "per_page": 10,
  "count": 1,
  "page": 1,
  "pages_count": 1,
  "phone_numbers": ["2145550816"]
}

This endpoint gets a list of unsubscribed phone numbers.

HTTP Request

GET https://app.tatango.com/api/v2/lists/ID/subscribers/unsubscribed

URL Parameters

Parameter	Description
ID	ID of the list

Custom Fields

Get a List of Custom Fields

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/ID/custom_fields')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Get.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/ID/custom_fields" -d '' -X GET \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "GET",
  "https://app.tatango.com/api/v2/lists/ID/custom_fields",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
request.send(null);

{
  "status": "OK",
  "custom_fields": [
    {
      "key": "some_custom_field_name",
      "pattern": "[A-Za-z0-9]",
      "max_length": 9999,
      "default_value": "The Default Value",
      "label": "The Label",
      "content_type": "text",
      "should_validate_regex_via_api": false
    }
  ]
}

HTTP Request

GET https://app.tatango.com/api/v2/lists/ID/custom_fields

URL Parameters

Parameter	Description
ID	ID of the list

Create a Custom Field

This endpoint creates a custom field.

HTTP Request

POST https://app.tatango.com/api/v2/lists/ID/custom_fields

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/ID/custom_fields')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Post.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
request.body(custom_field: {label: "The Label", key: "the_key", content_type: "text", max_length: 9999, pattern: "[A-Za-z0-9]", should_validate_regex_via_api: false, default_value: "The Default Value"})
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/ID/custom_fields" -d '{"custom_field": {"label": "The Label", "key": "the_key", "content_type": "text", "max_length": 9999, "pattern": "[A-Za-z0-9]", "should_validate_regex_via_api": false, "default_value": "The Default Value"}}' -X POST \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "POST",
  "https://app.tatango.com/api/v2/lists/ID/custom_fields",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
var data = JSON.stringify({
  custom_field: {
    label: "The Label",
    key: "the_key",
    content_type: "text",
    max_length: 9999,
    pattern: "[A-Za-z0-9]",
    should_validate_regex_via_api: false,
    default_value: "The Default Value",
  },
});
request.send(data);

{
  "status": "OK",
  "custom_field": {
    "list_id": 30,
    "key": "the_key",
    "pattern": "[A-Za-z0-9]",
    "max_length": 9999,
    "default_value": "The Default Value",
    "can_insert": true,
    "can_segment": true,
    "created_at": "2023-11-22T08:14:19.000-08:00",
    "updated_at": "2023-11-22T08:14:19.000-08:00",
    "mask": null,
    "label": "The Label",
    "content_type": "text",
    "should_validate_regex_via_api": false
  }
}

{
  "status": "error",
  "error": "Content type string not allowed. Allowed types are: text, datetime, number"
}

{
  "status": "error",
  "error": "Validation failed: Merge tag has already been taken, Label has already been taken"
}

URL Parameters

Parameter	Description
ID	ID of the list

JSON Parameters (JSON Object)

Parameter	Type	Description
custom_field[label]	string	A human-readable label
custom_field[key]	string	The custom field key. Must only contain lower case characters, numbers and underscores
custom_field[content_type]	string	Allowed content types are: text, datetime and number
custom_field[max_length]	integer	The max length allowed for data in this custom field. Maximum value is 9999.
custom_field[pattern]	regex	A validation regex for the content of the data in the custom field
custom_field[should_validate_regex_via_api]	boolean	Whether or not the pattern regex should be validated via the API
custom_field[default_value]	string	A default value for when none is provided. Must adhere to the `pattern` regex.

Deleting a Custom Field

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/ID/custom_fields')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Delete.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
request.body(key: "some_key")
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/ID/custom_fields" -d '{"key": "some_key"}' -X DELETE \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "DELETE",
  "https://app.tatango.com/api/v2/lists/ID/custom_fields",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
var data = JSON.stringify({
  key: "some_key",
});
request.send(data);

{
  "status": "Custom field successfully deleted"
}

This endpoint deletes a custom field.

HTTP Request

DELETE https://app.tatango.com/api/v2/lists/ID/custom_fields

URL Parameters

Parameter	Description
ID	ID of the list

JSON Parameters (JSON Object)

Key	Description
key	The custom field key

Key	Description
tags	An array of tag names

Messaging

The following characters can be used: a-z, A-Z, 0-9 and these special characters: .,:;!?()~=+-_\/@$#&%

160 characters max

Retrieve All Sent Messages in a List

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/<ID>/messages')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Get.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
request.body({"start_date":"20160901", "end_date":"20161030"});
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/<ID>/messages" -d '{"start_date":"20160901", "end_date":"20161030"}' -X GET \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "GET",
  "https://app.tatango.com/api/v2/lists/<ID>/messages",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
var data = JSON.stringify({ start_date: "20160901", end_date: "20161030" });
request.send(data);

{
  "status": "OK",
  "per_page": 10,
  "count": 2,
  "page": 1,
  "pages_count": 1,
  "messages": [
    {
      "id": 14523,
      "content": "AMCE Retail: Save $20 off this weekend when you spend more than $100 in-store. Show this text message to redeem. Reply STOP to end.",
      "status": "sent",
      "sent_at": "2016-09-07T14:10:53-07:00",
      "name": "my message name",
      "is_broadcast": true,
      "recipient_count": 679571,
      "success_count": 675232,
      "bounces_count": 4339,
      "pending_count": 0,
      "clean_count": 2342,
      "unsubscribe_count": 1362,
      "sms_count": 168808,
      "mms_count": 506424,
      "send_cost": 5096.78,
      "cancelled_at": null,
      "parts": {
        "sum": 679599,
        "minimum": 1,
        "maximum": 2
      }
    },
    {
      "id": 14523,
      "content": "AMCE Retail: Go to http://bit.ly/acme to see deals on anvils. Or check https://trackinglink.com. Reply STOP to end.",
      "sent_at": "2016-10-07T14:10:53-07:00",
      "status": "sent",
      "name": "another message name",
      "is_broadcast": true,
      "recipient_count": 679571,
      "success_count": 675232,
      "bounces_count": 4339,
      "pending_count": 0,
      "clean_count": 2342,
      "unsubscribe_count": 1362,
      "sms_count": 168808,
      "mms_count": 506424,
      "send_cost": 5096.78,
      "message_links": [
        {
          "id": 42,
          "link": "http://bit.ly/acme",
          "count": 2356,
          "display_count": 2356
        }
      ],
      "tracking_links": [
        {
          "link": "https://trackinglink.com",
          "click_count": 15,
          "unique_click_count": 10
        }
      ],
      "cancelled_at": null,
      "parts": {
        "sum": 679599,
        "minimum": 1,
        "maximum": 2
      }
    }
  ]
}

This endpoint retrieves all sent messages in a list.

Please note the message_links attribute will only be present on messages that have bit.ly links in their content.

Please note the tracking_links attribute will only be present on messages that have tracking links in their content.

Please note the parts attribute will be available 30 minutes after the message was sent.

HTTP Request

GET https://app.tatango.com/api/v2/lists/<ID>/messages

URL Parameters

Parameter	Description
ID	The ID of the list
start_date	(optional) A date in YYYYMMDD format. Messages sent before this date will not be returned (UTC).
end_date	(optional) A date in YYYYMMDD format. Messages sent after this date will not be returned (UTC).

Retrieve All Draft Messages in a List

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/<ID>/messages/draft')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Get.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
request.body({"start_date":"20160901", "end_date":"20161030"});
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/<ID>/messages/draft" -d '{"start_date":"20160901", "end_date":"20161030"}' -X GET \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "GET",
  "https://app.tatango.com/api/v2/lists/<ID>/messages/draft",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
var data = JSON.stringify({ start_date: "20160901", end_date: "20161030" });
request.send(data);

{
  "status": "OK",
  "per_page": 10,
  "count": 2,
  "page": 1,
  "pages_count": 1,
  "messages": [
    {
      "id": 14523,
      "content": "AMCE Retail: Save $20 off this weekend when you spend more than $100 in-store. Show this text message to redeem. Reply STOP to end.",
      "sent_at": "2016-09-07T14:10:53-07:00",
      "status": "draft",
      "name": "my message name",
      "is_broadcast": false,
      "recipient_count": 0,
      "success_count": 0,
      "bounces_count": 0,
      "pending_count": 0,
      "clean_count": 0,
      "unsubscribe_count": 0,
      "sms_count": 0,
      "mms_count": 0,
      "send_cost": 0.0,
      "attachment": "https://url-to-your-mms-attachment"
    },
    {
      "id": 14523,
      "content": "AMCE Retail: Go to http://bit.ly/acme to see deals on anvils. Reply STOP to end.",
      "sent_at": "2016-10-07T14:10:53-07:00",
      "status": "draft",
      "name": "another message name",
      "is_broadcast": false,
      "recipient_count": 0,
      "success_count": 0,
      "bounces_count": 0,
      "pending_count": 0,
      "clean_count": 0,
      "unsubscribe_count": 0,
      "sms_count": 0,
      "mms_count": 0,
      "send_cost": 0.0,
      "attachment": "https://url-to-your-mms-attachment",
      "message_links": [
        {
          "id": 42,
          "link": "http://bit.ly/acme",
          "count": 0,
          "display_count": 0
        }
      ]
    }
  ]
}

This endpoint retrieves all draft messages in a list.

HTTP Request

GET https://app.tatango.com/api/v2/lists/<ID>/messages/draft

URL Parameters

Parameter	Description
ID	The ID of the list
start_date	(optional) A date in YYYYMMDD format. Drafts created before this date will not be returned (UTC).
end_date	(optional) A date in YYYYMMDD format. Drafts created after this date will not be returned (UTC).

Retrieve All Scheduled Messages in a List

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/<ID>/messages/scheduled')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Get.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
request.body({"start_date":"20160901", "end_date":"20161030"});
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/<ID>/messages/scheduled" -d '{"start_date":"20160901", "end_date":"20161030"}' -X GET \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "GET",
  "https://app.tatango.com/api/v2/lists/<ID>/messages/scheduled",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
var data = JSON.stringify({ start_date: "20160901", end_date: "20161030" });
request.send(data);

{
  "status": "OK",
  "per_page": 10,
  "count": 2,
  "page": 1,
  "pages_count": 1,
  "messages": [
    {
      "id": 14523,
      "content": "AMCE Retail: Save $20 off this weekend when you spend more than $100 in-store. Show this text message to redeem. Reply STOP to end.",
      "sent_at": "2016-09-07T14:10:53-07:00",
      "status": "scheduled",
      "name": "my message name",
      "is_broadcast": false,
      "recipient_count": 0,
      "success_count": 0,
      "bounces_count": 0,
      "pending_count": 0,
      "clean_count": 0,
      "unsubscribe_count": 0,
      "sms_count": 0,
      "mms_count": 0,
      "send_cost": 0.0,
      "attachment": "https://url-to-your-mms-attachment"
    },
    {
      "id": 14523,
      "content": "AMCE Retail: Go to http://bit.ly/acme to see deals on anvils. Reply STOP to end.",
      "sent_at": "2016-10-07T14:10:53-07:00",
      "status": "scheduled",
      "name": "another message name",
      "is_broadcast": false,
      "recipient_count": 0,
      "success_count": 0,
      "bounces_count": 0,
      "pending_count": 0,
      "clean_count": 0,
      "unsubscribe_count": 0,
      "sms_count": 0,
      "mms_count": 0,
      "send_cost": 0.0,
      "attachment": "https://url-to-your-mms-attachment",
      "message_links": [
        {
          "id": 42,
          "link": "http://bit.ly/acme",
          "count": 0,
          "display_count": 0
        }
      ]
    }
  ]
}

This endpoint retrieves all scheduled messages in a list.

HTTP Request

GET https://app.tatango.com/api/v2/lists/<ID>/messages/scheduled

URL Parameters

Parameter	Description
ID	The ID of the list
start_date	(optional) A date in YYYYMMDD format. Scheduled messages scheduled to send before this date will not be returned (UTC).
end_date	(optional) A date in YYYYMMDD format. Scheduled messages scheduled to send after this date will not be returned (UTC).

Sending Message to Entire List

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/ID/messages')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Post.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
request.body({"message":{"content":"Hello, world!"}});
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/ID/messages" -d '{"message":{"content":"Hello, world!"}}' -X POST \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open("POST", "https://app.tatango.com/api/v2/lists/ID/messages", false);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
var data = JSON.stringify({ message: { content: "Hello, world!" } });
request.send(data);

{
  "status": "OK",
  "message": {
    "id": 4
  }
}

This endpoint sends a message.

HTTP Request

POST https://app.tatango.com/api/v2/lists/ID/messages

URL Parameters

Parameter	Description
ID	ID of the list

JSON Parameters (JSON Object)

Parameter	Description
message[content]	Message content

Querying an Existing Message

Please be aware that it takes some time after a message is sent to receive delivery status notifications from the various carriers. We recommend waiting until at least 10 minutes after a message is sent to query for delivery statistics.

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/ID/messages/MESSAGE_ID')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Get.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/ID/messages/MESSAGE_ID" -d '' -X GET \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "GET",
  "https://app.tatango.com/api/v2/lists/ID/messages/MESSAGE_ID",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
request.send(null);

{
  "status": "OK",
  "message": {
    "id": 14523,
    "content": "AMCE Retail: Go to http://bit.ly/acme to see deals on anvils. Reply STOP to end.",
    "sent_at": "2016-09-07T14:10:53-07:00",
    "status": "sent",
    "name": "my message name",
    "is_broadcast": true,
    "recipient_count": 679571,
    "success_count": 675232,
    "bounces_count": 4339,
    "pending_count": 0,
    "clean_count": 2342,
    "unsubscribe_count": 1362,
    "sms_count": 168808,
    "mms_count": 506424,
    "send_cost": 5096.78,
    "attachment": "https://url-to-your-mms-attachment",
    "cancelled_at": null,
    "message_links": [
      {
        "id": 42,
        "link": "http://bit.ly/acme",
        "count": 2356,
        "display_count": 2356
      }
    ],
    "parts": {
      "sum": 679599,
      "minimum": 1,
      "maximum": 2
    }
  }
}

This endpoint retrieves a message.

Please note the message_links attribute will only be present on messages that have bit.ly links in their content.

Please note the parts attribute will be available 30 minutes after the message was sent.

HTTP Request

GET https://app.tatango.com/api/v2/lists/ID/messages/MESSAGE_ID

URL Parameters

Parameter	Description
ID	ID of the list
MESSAGE_ID	ID of the message

Responses Explained

Key	Description
content	The actual content of the message that was sent to subscribers.
id	A unique ID that identifies this specific message.
name	An optional name or description for a message.
sent_at	The date/time this message completed it's send.
status	The status of the message.
is_broadcast	If true, the message was sent to the whole list. If false, was sent only to the phone_number specified.
phone_number	The wireless phone number of the subscriber.
recipient_count	The number of recipients the message was sent to.
success_count	The number of recipients that succesfully received the message on their mobile phones.
bounces_count	The number of recipients that did not receive the message on their mobile phones.
pending_count	The number of messages that do not have a delivery status as of the time of the query.
clean_count	The number of recipients that Tatango automatically unsubscribed from your list due to our
unsubscribe_count	The number of recipients that unsubscribed from the list, in response to the message that was sent to them.

Message Log (MOMT) Reports

Creating a New MOMT Report

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/momt_reports')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Post.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
request.body({"date_from":"2016-08-08T22:10:41+01:00","date_to":"2016-09-07T22:10:41+01:00","webhook_callback_url":"http://requestb.in/1d60vok1"})
response = http.request(request)

curl "https://app.tatango.com/api/v2/momt_reports" -d '{"date_from":"2016-08-08T22:10:41+01:00","date_to":"2016-09-07T22:10:41+01:00","webhook_callback_url":"http://requestb.in/1d60vok1"}' -X POST \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open("POST", "https://app.tatango.com/api/v2/momt_reports", false);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
var data = JSON.stringify({
  date_from: "2016-08-08T22:10:41+01:00",
  date_to: "2016-09-07T22:10:41+01:00",
  webhook_callback_url: "http://requestb.in/1d60vok1",
});
request.send(data);

{
  "status": "OK",
  "momt_report": {
    "id": 3,
    "account_id": 22,
    "s3_url": null,
    "import_started_at": null,
    "import_completed_at": null,
    "total_rows": null,
    "processed_rows": 0,
    "percent_complete": 0,
    "mo_count": 0,
    "mt_count": 0,
    "shortcode": null,
    "date_range": "json",
    "date_from": "2016-08-08T22:10:41+01:00",
    "date_to": "2016-09-07T22:10:41+01:00",
    "campaign": null,
    "carrier": null,
    "phone_number": null,
    "direction": null,
    "status_array": null,
    "created_at": "2016-09-07T14:10:41-07:00",
    "updated_at": "2016-09-07T14:10:41-07:00",
    "counts_calculated": false,
    "type": null,
    "is_csv": false,
    "webhook_callback_url": null,
    "run_errors": null,
    "message_type": null,
    "cancelled": null
  }
}

This endpoint creates a new MOMT Report.

HTTP Request

POST https://app.tatango.com/api/v2/momt_reports

JSON Parameters (JSON Object)

Parameter	Description
date_from	{:scope=>:momt_reports}
date_to	{:scope=>:momt_reports}
webhook_callback_url	{:scope=>:momt_reports}

Getting Status of a Processed MOMT Report

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/momt_reports/ID')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Get.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
response = http.request(request)

curl "https://app.tatango.com/api/v2/momt_reports/ID" -d '' -X GET \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open("GET", "https://app.tatango.com/api/v2/momt_reports", false);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
request.send(null);

{
  "status": "OK",
  "momt_report": {
    "id": 1,
    "account_id": 20,
    "s3_url": null,
    "import_started_at": null,
    "import_completed_at": null,
    "total_rows": null,
    "processed_rows": 0,
    "percent_complete": 0,
    "mo_count": 0,
    "mt_count": 0,
    "shortcode": null,
    "date_range": "json",
    "date_from": "2016-08-08T22:10:41+01:00",
    "date_to": "2016-09-07T22:10:41+01:00",
    "campaign": null,
    "carrier": null,
    "phone_number": null,
    "direction": null,
    "status_array": null,
    "created_at": "2016-09-07T14:10:41-07:00",
    "updated_at": "2016-09-07T14:10:41-07:00",
    "counts_calculated": true,
    "type": null,
    "is_csv": false,
    "webhook_callback_url": null,
    "run_errors": null,
    "message_type": null,
    "cancelled": null
  }
}

This endpoint gets the status of a processed MOMT Report.

HTTP Request

GET https://app.tatango.com/api/v2/momt_reports/ID

URL Parameters

Parameter	Description
ID	ID of MOMT Report to get status of

Getting Status of a Unprocessed MOMT Report

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/momt_reports/ID')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Get.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
response = http.request(request)

curl "https://app.tatango.com/api/v2/momt_reports/ID" -d '' -X GET \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open("GET", "https://app.tatango.com/api/v2/momt_reports", false);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
request.send(null);

{
  "status": "OK",
  "momt_report": {
    "id": 2,
    "account_id": 21,
    "s3_url": null,
    "import_started_at": null,
    "import_completed_at": null,
    "total_rows": null,
    "processed_rows": 0,
    "percent_complete": 0,
    "mo_count": 0,
    "mt_count": 0,
    "shortcode": null,
    "date_range": "json",
    "date_from": "2016-08-08T22:10:41+01:00",
    "date_to": "2016-09-07T22:10:41+01:00",
    "campaign": null,
    "carrier": null,
    "phone_number": null,
    "direction": null,
    "status_array": null,
    "created_at": "2016-09-07T14:10:41-07:00",
    "updated_at": "2016-09-07T14:10:41-07:00",
    "counts_calculated": false,
    "type": null,
    "is_csv": false,
    "webhook_callback_url": null,
    "run_errors": null,
    "message_type": null,
    "cancelled": null
  }
}

This endpoint gets the status of an unprocessed MOMT Report.

HTTP Request

GET https://app.tatango.com/api/v2/momt_reports/ID

URL Parameters

Parameter	Description
ID	ID of MOMT Report to get status of

Shortcodes

Listing Account Short Codes

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/shortcodes')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Get.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
response = http.request(request)

curl "https://app.tatango.com/api/v2/shortcodes" -d '' -X GET \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open("GET", "https://app.tatango.com/api/v2/shortcodes", false);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
request.send(null);

{
  "status": "OK",
  "shortcodes": ["33733"]
}

This endpoint gets a list of short codes provisioned on your account.

HTTP Request

GET https://app.tatango.com/api/v2/shortcodes

Testing Keyword Availability on Short Code

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/shortcodes/ID/test_keyword')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Post.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
request.body({"keyword_name":"TEST"});
response = http.request(request)

curl "https://app.tatango.com/api/v2/shortcodes/ID/test_keyword" -d '{"keyword_name":"TEST"}' -X POST \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "POST",
  "https://app.tatango.com/api/v2/shortcodes/ID/test_keyword",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
var data = JSON.stringify({ keyword_name: "TEST" });
request.send(data);

{
  "status": "OK",
  "keyword_name": "available"
}

This endpoint gets checks the availability of a keyword on the account's short code.

HTTP Request

POST https://app.tatango.com/api/v2/shortcodes/ID/test_keyword

URL Parameters

Parameter	Description
ID	ID of the shortcode

JSON Parameters (JSON Object)

Parameter	Description
keyword_name	Keyword name to test

FAQs

What are the limitations for a keyword?
- A keyword must contain at least two characters and no more than 15 characters.
- Keywords are not case sensitive. FOO will match foo and FOO and Foo.
- You can't use obscene words. We're not going to spell them out here.
Are keywords case sensitive?
No. The system checks for duplicate keywords by transforming all keywords to uppercase before performing matching algorithms.
What happens if the keyword isn't available?
The response from the API will be a 422 error with the response body looking like this: {"status":"error","error":"invalid keyword names: EXISTINGKW"}
What happens if the keyword isn't available?
Yes. By utilizing this endpoint. The response will either be 200 OK {"status":"OK","keyword_name":"available"} or 200 OK {"status":"OK","keyword_name":"unavailable","error":"Name is in use"}.

Transactional Messages

Send Transactional SMS Message

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/transactional_messages')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Post.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
request.body({"transactional_message":{"number":"2835550430","content":"Test me!"}})
response = http.request(request)

curl "https://app.tatango.com/api/v2/transactional_messages" -d '{"transactional_message":{"number":"2835550430","content":"Test me!"}}' -X POST \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "POST",
  "https://app.tatango.com/api/v2/transactional_messages",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
var data = JSON.stringify(
  '{"transactional_message":{"number":"2835550430","content":"Test me!"}}'
);
request.send(data);

{
  "status": "Message successfully sent.",
  "transactional_message": {
    "id": 1,
    "number": "2835550430",
    "content": "Test me!",
    "status": "pending"
  }
}

{
  "type": "transactional_message_reply",
  "transactional_message_id": 589733,
  "received_at": "2016-08-20T15:12:37-07:00",
  "phone_number": "3474437987",
  "carrier": 383,
  "carrier_name": "AT&T",
  "content": "I replied to transactional"
}

This endpoint sends a Transactional SMS Message.

HTTP Request

POST https://app.tatango.com/api/v2/transactional_messages

JSON Parameters (JSON Object)

Parameter	Description
transactional_message[number]	required Phone number (numbers only - no spaces, dashes or other characters)
transactional_message[content]	required Message content
transactional_message[webhook_callback_url]	Webhook url (will send result of send to)

Send Transactional MMS Message

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/transactional_messages')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Post.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
request.body({"transactional_message":{"number":"2835550430","is_mms":true,"subject":"MMS message subject. Optional max-size 40","content":"Message content required. Max-size 5000 if is_mms","fallback_content":"MMS message content (required if is_mms)","attachment_id":42}})
response = http.request(request)

curl "https://app.tatango.com/api/v2/transactional_messages" -d '{"transactional_message":{"number":"2835550430","is_mms":true,"subject":"MMS message subject. Optional max-size 40","content":"Message content required. Max-size 5000 if is_mms","fallback_content":"MMS message content (required if is_mms)","attachment_id":42' -X POST \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "POST",
  "https://app.tatango.com/api/v2/transactional_messages",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
var data = JSON.stringify(
  '{"transactional_message":{"number":"2835550430","is_mms":true,"subject":"MMS message subject. Optional max-size 40","content":"Message content required. Max-size 5000 if is_mms","fallback_content":"MMS message content (required if is_mms)","attachment_id":42}'
);
request.send(data);

{
  "status": "Message successfully sent.",
  "transactional_message": {
    "id": 1,
    "number": "2835550430",
    "content": "Message content required. Max-size 5000 if is_mms",
    "status": "pending"
  }
}

{
  "type": "transactional_message_reply",
  "transactional_message_id": 589733,
  "received_at": "2016-08-20T15:12:37-07:00",
  "phone_number": "3474437987",
  "carrier": 383,
  "carrier_name": "AT&T",
  "content": "I replied to transactional"
}

This endpoint sends a Transactional SMS Message.

HTTP Request

POST https://app.tatango.com/api/v2/transactional_messages

JSON Parameters (JSON Object)

Parameter	Description
transactional_message[number]	required Phone number (numbers only - no spaces, dashes or other characters)
transactional_message[content]	required Message content
transactional_message[webhook_callback_url]	Webhook url (will send result of send to)

Webhooks

Callback URLs configured as a webhook in Tatango are retried 10 times when not reachable. After the 10th time, the system makes no further attempts to reach the callback URL.

Creating a New Webhook for a List

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/ID/webhooks')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Post.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
request.body({"webhook":{"callback_url":"http://localhost.dev/null?api_key=foo_bar_baz","subscribe":true,"unsubscribe":true,"message_sent":false}})
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/ID/webhooks/WEBHOOK_ID" -d '{"webhook":{"callback_url":"http://localhost.dev/null?api_key=foo_bar_baz","subscribe":true,"unsubscribe":true,"message_sent":false}}' -X POST \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open("POST", "https://app.tatango.com/api/v2/lists/ID/webhooks/WEBHOOK_ID", false);
request.setRequestHeader("Authorization", "Basic " + btoa("emailaddress@mydomain.com:my_api_key"));
var data = JSON.stringify({"webhook":{"callback_url":"http://localhost.dev/null?api_key=foo_bar_baz","subscribe":true,"unsubscribe":true,"message_sent":false}};
request.send(data);

{
  "status": "Webhook created",
  "webhook": {
    "callback_url": "http://localhost.dev/null?api_key=foo_bar_baz",
    "created_at": "2016-09-07T14:11:13-07:00",
    "enabled": true,
    "id": 4,
    "list_id": 29,
    "message_sent": false,
    "subscribe": true,
    "unsubscribe": true,
    "updated_at": "2016-09-07T14:11:13-07:00"
  }
}

This endpoint creates a webhook for a list

HTTP Request

POST https://app.tatango.com/api/v2/lists/ID/webhooks

URL Parameters

Parameter	Description
ID	The ID of the list

Updating a Webhook

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/ID/webhooks/WEBHOOK_ID')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Put.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
request.body({"webhook":{"callback_url":"http://mynewapi.com/?ref=tatango","subscribe":true,"unsubscribe":false,"message_sent":false}})
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/ID/webhooks/WEBHOOK_ID" -d '{"webhook":{"callback_url":"http://mynewapi.com/?ref=tatango","subscribe":true,"unsubscribe":false,"message_sent":false}}' -X PUT \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "PUT",
  "https://app.tatango.com/api/v2/lists/ID/webhooks/WEBHOOK_ID",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
var data = JSON.stringify({
  webhook: {
    callback_url: "http://mynewapi.com/?ref=tatango",
    subscribe: true,
    unsubscribe: false,
    message_sent: false,
  },
});
request.send(data);

{
  "status": "Webhook updated",
  "webhook": {
    "callback_url": "http://mynewapi.com/?ref=tatango",
    "created_at": "2016-09-07T14:11:13-07:00",
    "enabled": true,
    "id": 9,
    "list_id": 33,
    "message_sent": false,
    "subscribe": true,
    "unsubscribe": false,
    "updated_at": "2016-09-07T14:11:13-07:00"
  }
}

This endpoint updates a webhook

HTTP Request

PUT https://app.tatango.com/api/v2/lists/ID/webhooks/WEBHOOK_ID

URL Parameters

Parameter	Description
ID	The ID of the list
WEBHOOK_ID	The ID of the webhook

Showing a Webhook

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/ID/webhooks/WEBHOOK_ID')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Get.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/ID/webhooks/WEBHOOK_ID" -d '' -X GET \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "GET",
  "https://app.tatango.com/api/v2/lists/ID/webhooks/WEBHOOK_ID",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
request.send(null);

{
  "status": "OK",
  "webhook": {
    "callback_url": "http://localhost/dev/null",
    "created_at": "2016-09-07T14:11:13-07:00",
    "enabled": true,
    "id": 5,
    "list_id": 30,
    "message_sent": false,
    "subscribe": true,
    "unsubscribe": false,
    "updated_at": "2016-09-07T14:11:13-07:00"
  }
}

This endpoint shows a webhook.

HTTP Request

GET https://app.tatango.com/api/v2/lists/ID/webhooks/WEBHOOK_ID

URL Parameters

Parameter	Description
ID	The ID of the list
WEBHOOK_ID	The ID of the webhook

Listing Webhooks

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/ID/webhooks')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Get.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/ID/webhooks" -d '' -X GET \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open("GET", "https://app.tatango.com/api/v2/lists/ID/webhooks", false);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
request.send(null);

{
  "status": "OK",
  "per_page": 10,
  "count": 3,
  "page": 1,
  "pages_count": 1,
  "webhooks": [
    {
      "callback_url": "http://localhost/dev/null",
      "created_at": "2016-09-07T14:11:13-07:00",
      "enabled": true,
      "id": 6,
      "list_id": 31,
      "message_sent": false,
      "subscribe": true,
      "unsubscribe": false,
      "updated_at": "2016-09-07T14:11:13-07:00"
    },
    {
      "callback_url": "http://localhost/dev/null",
      "created_at": "2016-09-07T14:11:13-07:00",
      "enabled": true,
      "id": 7,
      "list_id": 31,
      "message_sent": false,
      "subscribe": true,
      "unsubscribe": false,
      "updated_at": "2016-09-07T14:11:13-07:00"
    },
    {
      "callback_url": "http://localhost/dev/null",
      "created_at": "2016-09-07T14:11:13-07:00",
      "enabled": true,
      "id": 8,
      "list_id": 31,
      "message_sent": false,
      "subscribe": true,
      "unsubscribe": false,
      "updated_at": "2016-09-07T14:11:13-07:00"
    }
  ]
}

This endpoint lists webhooks.

HTTP Request

GET https://app.tatango.com/api/v2/lists/ID/webhooks

URL Parameters

Parameter	Description
ID	The ID of the list

Destroying a Webhook

require 'net/http'
require 'uri'

uri = URI.parse('https://app.tatango.com/api/v2/lists/ID/webhooks/WEBHOOK_ID')
http = Net::HTTP.new(uri.host, uri.port)
request = Net:HTTP::Delete.new(uri.request_url)
request.basic_auth("emailaddress@mydomain.com", "my_api_key")
response = http.request(request)

curl "https://app.tatango.com/api/v2/lists/ID/webhooks/WEBHOOK_ID" -d '' -X DELETE \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "

var request = new XMLHttpRequest();
request.open(
  "DELETE",
  "https://app.tatango.com/api/v2/lists/ID/webhooks/WEBHOOK_ID",
  false
);
request.setRequestHeader(
  "Authorization",
  "Basic " + btoa("emailaddress@mydomain.com:my_api_key")
);
request.send(null);

{
  "status": "Webhook destroyed"
}

This endpoint destroys a webhook.

HTTP Request

DELETE https://app.tatango.com/api/v2/lists/ID/webhooks/WEBHOOK_ID

URL Parameters

Parameter	Description
ID	The ID of the list
WEBHOOK_ID	The ID of the webhook

General FAQs

Where can I find the "ID of the list"?
You can find the ID of all of your lists by calling the Listing all Lists" endpoint.
What are the differences between SMS and MMS?
SMS (short message service) is a text-only message service. MMS (multimedia messaging service) is a service that allows the sender to send a multimedia message.

Carrier IDs

This section provides a list of carrier ID and names (US and Canada) for any response that includes carrier and carrierName

United States Carriers

Carrier Name	Carrier ID
Alaska Communications Systems (ACS)	592
ASTAC	10242
AT&T	383
Atlantic Tele-Network International (ATNI)	10542
bandwidth.com (includes Republic Wireless)	766
Blue Wireless	11264
Boost Mobile	534
Boost-CDMA	586
Brightlink	10212
C Spire Wireless (aka Cellular South)	386
Carolina West Wireless	564
CellCom	587
Cellular One of N.E. Arizona	566
Chariton Valley Cellular	701
Chat Mobility	619
Cleartalk (Flat Wireless)	656
Copper Valley Telecom	802
Cordova	10282
Cross Wireless	618
Duet Wireless	696
East Kentucky Network (Appalachian Wireless)	570
Enflick	10262
Fair Point Communications	803
GCI Communications	603
Google Voice	798
Illinois Valley Cellular	574
Inland Cellular	575
Inteliquent	10232
Interop All Carriers	697
IWireless	477
Jasper Wireless	11284
Leaco Rural Telephone Cooperative	783
Level 3 (internal only)	801
Ligado Networks	11251
Limitless Mobile	588
MetroPCS (GSM)	788
Mid-Rivers Communications	834
MobileNation/SI Wireless	773
Mosaic Telecom	658
MTA Wireless/Matanuska Kenai	774
MTPCS Cellular One (Cellone Nation)	655
Nemont CDMA	796
Nemont US UMTS	873
NewCore Wireless US	11287
Nex Tech Communications	578
Northwest Missouri Cellular	620
Panhandle Wireless	626
Peoples Wireless	694
Pine Belt	10352
Pine Cellular	580
Pioneer Cellular	621
Plateau Wireless	651
Rock Wireless	11252
Rural Independent Network Alliance (RINA)	567
Shelcomm	11293
SouthernLINC	763
Sprint	34
SRT Communications	780
T-Mobile	79
Thumb Cellular	604
TracFone (AT&T)	556
Triangle Communications US	11290
Triangle Wireless	10272
Union Telephone	549
Union Wireless	11286
United States Cellular Corp	56
United Wireless	602
Verizon	77
Viaero US	11289
Viaero Wireless	650
Virgin Mobile	525
West Central Wireless	559

Canadian Carriers

Carrier Name	Carrier ID
Aliant	509
Bell Mobility	80
Eastlink Wireless	799
Execulink	10573
Fido (Microcell)	138
Freedom Canada	11292
Mobilicity	654
MTS	510
NorthernTel	512
Rogers	75
Sasktel	102
Telebec	511
Telus	70
Videotron	615
Virgin Mobile	537
WIND	653

Errors

The tatango API uses the following error codes:

Error Code	Meaning
400	Bad Request -- Your request is invalid.
401	Unauthorized -- Your API key is wrong.
403	Forbidden -- You are not authorized for this request.
404	Not Found -- The specified endpoint could not be found.
405	Method Not Allowed -- You tried to access an endpoint with an invalid method.
406	Not Acceptable -- You requested a format that isn't JSON.
410	Gone -- The requested resource has been removed from our servers.
422	Unprocessable Entity - There was a problem of some sort with either the JSON or request parameters you supplied. Usually, this error will be accompanied by a detailed description of the problem.
429	Too Many Requests -- You're requesting too many resources! Slow down!
500	Internal Server Error -- We had a problem with our server. Try again later.
502	Bad Gateway -- We had a problem with our server. Try again later.
503	Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

Before You Start

Rate Limits

Returning multiple results and pagination

Authentication

Accounts

Get Current Account

HTTP Request

Lists

List all Lists

HTTP Request

Retrieve List

HTTP Request

URL Parameters

Configure List Opt-In Type

HTTP Request

URL Parameters

JSON Parameters (JSON Object)

Creating a New List

HTTP Request

JSON Parameters (JSON Object)

Destroying a List

HTTP Request

URL Parameters

Setting(Updating) Keywords for a List

HTTP Request

URL Parameters

JSON Parameters (JSON Object)

Updating a List

HTTP Request

URL Parameters

JSON Parameters (JSON Object)

Subscribers

Adding a Subscriber

HTTP Request

URL Parameters

JSON Parameters (JSON Object)

Responses Explained

Getting a Subscriber

HTTP Request

URL Parameters

Responses Explained

Updating a Subscriber

Responses Explained

HTTP Request

URL Parameters

JSON Parameters (JSON Object)

Adding Multiple Tags to Multiple Subscribers

Responses Explained

HTTP Request

URL Parameters

JSON Parameters (JSON Object)

Other uses

Unsubscribing a Subscriber

HTTP Request

URL Parameters

Responses Explained

Get a List of Subscribed Phone Numbers

HTTP Request

URL Parameters

Get a List of Unsubscribed Phone Numbers

HTTP Request

URL Parameters

Custom Fields

Get a List of Custom Fields

HTTP Request

URL Parameters

Create a Custom Field

HTTP Request

URL Parameters

JSON Parameters (JSON Object)

Deleting a Custom Field

HTTP Request

URL Parameters

JSON Parameters (JSON Object)

Tags

Deleting a tag from all subscribers

HTTP Request

URL Parameters

JSON Parameters (JSON Object)

Messaging