Understanding API rate limits and best practices

Rate Limits

Tatango

Introduction

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

Get Current Account

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

List All Lists

Retrieve List

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

Configure List Opt-In Type

Creating a New List

Destroying a List

This endpoint sets or updates keywords for a list.

Setting Keywords for a List

Updating a List

This endpoint adds a subscriber to a list.

Adding a Subscriber

This endpoint returns information about a current subscriber.

Getting a Subscriber

Updating a Subscriber

This endpoint applies multiple tags to multiple subscribers.

Adding Multiple Tags to Multiple Subscribers

This endpoint deletes multiple tags from a subscriber.

Deleting tags from a Subscriber

Unsubscribing a Subscriber

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

Get a List of Subscribed Phone Numbers

This endpoint gets a list of unsubscribed phone numbers.

Get a List of Unsubscribed Phone Numbers

This endpoint fetches a list of Custom Fields.

Get a List of Custom Fields

Create a Custom Field

Deleting a Custom Field

This endpoint deletes tags from all subscribers with the tag.

Deleting a Tag From All Subscribers

This endpoint retrieves all sent messages in a list.

Retrieve All Sent Messages in a List

This endpoint retrieves all draft messages in a list.

Retrieve All Draft Messages in a List

This endpoint retrieves all scheduled messages in a list.

Retrieve All Scheduled Messages in a List

Send Message to Entire List

Querying an Existing Message

Creating a New MOMT Report

This endpoint gets the status of a processed MOMT Report.

Getting Status of a Processed MOMT Report

This endpoint gets the status of an unprocessed MOMT Report.

Getting Status of a Unprocessed MOMT Report

This endpoint gets a list of shortcodes provisioned on your account.

Listing Account Shortcodes

This endpoint checks the availability of a keyword on the account's shortcode.

Testing Keyword Availability on Shortcode

This endpoint sends a Transactional SMS Message. Transactional SMS Messages are limited to 160 characters. Messages sent with more than 160 characters will be rejected with a 422 response and an error message stating that the content is too long.

Send Transactional SMS Message

This endpoint sends a Transactional MMS Message. Transactional MMS Messages are limited to 5000 characters.

Send Transactional MMS Message

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.

Webhook Events

This endpoint creates a webhook for a list

Creating a New Webhook for a List

Updating a Webhook

Showing a Webhook

Listing Webhooks

Destroying a Webhook

This endpoint allows you to send an SMS message to a U.S. or Canadian phone number.

Send an SMS Message

This endpoint allows you to send an MMS message to a U.S. or Canadian phone number. If delivery fails, a fallback SMS message will be sent.

Send an MMS Message

This endpoint allows you to send a WhatsApp Templated Message along with an SMS Fallback. The SMS Fallback is used if the WhatsApp message fails to deliver.

v2 API Reference

Accounts

Lists

Subscribers

Custom Fields

Tags

Messaging

Message Log (MOMT) Reports

Shortcodes

Transactional Messages

Webhooks

Rate Limits