Send Transactional SMS Message

cURL

curl "https://app.tatango.com/api/v2/transactional_messages" -d '{"phone_number":"2141234567","content":"Hello from Tatango!"}' -X POST \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -u [email protected]:my_api_key \
  -H "Host: example.org" \
  -H "Cookie: "

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

POST

api

transactional_messages

cURL

curl "https://app.tatango.com/api/v2/transactional_messages" -d '{"phone_number":"2141234567","content":"Hello from Tatango!"}' -X POST \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -u [email protected]:my_api_key \
  -H "Host: example.org" \
  -H "Cookie: "

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

Request URL

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

Authorizations

Authorization

string

header

required

Tatango authenticates API requests by validating an API key passed via HTTP Basic Authentication. Use your login email as the username and your API key as the password.

Body

application/json

transactional_message

object

Show child attributes

transactional_message.number

string

required

Phone number (numbers only - no spaces, dashes or other characters).

transactional_message.content

string

required

Message content

Maximum string length: 5000

transactional_message.is_mms

boolean

required

Accepts true or false. If true message will be sent as MMS. If false, message will be sent as SMS.

transactional_message.subject

string

The subject line of your message. The subject is bold and sent above the content included in your request. This is required if is_mms is true.

transactional_message.fallback_content

string

Fallback content is text only, and is sent in the case that the handset is unable to receive MMS messages, limited to 160 characters. This is required if is_mms is true.

Maximum string length: 160

transactional_message.attachment_id

integer

The attachment_id is the id that references the media attachment to include in an MMS message. This is required if is_mms is true.

transactional_message.webhook_callback_url

string

Webhook url (will send result of send to).

Response

Message successfully sent

status

string

Example:

"Message successfully sent."

transactional_message

object

Show child attributes

transactional_message.id

integer

Example:

1

transactional_message.number

string

Example:

"2835550430"

transactional_message.content

string

Example:

"Message content required. Max-size 5000 if is_mms"

transactional_message.status

string

Example:

"pending"

Testing Keyword Availability on Shortcode Send Transactional MMS Message

⌘I

v2 API Reference

Accounts

Lists

Subscribers

Custom Fields

Tags

Messaging

Message Log (MOMT) Reports

Shortcodes

Transactional Messages

Webhooks

Send Transactional SMS Message

Request URL

Authorizations

Body

Response

v2 API Reference

Accounts

Lists

Subscribers

Custom Fields

Tags

Messaging

Message Log (MOMT) Reports

Shortcodes

Transactional Messages

Webhooks

​Request URL

Authorizations

Body

Response

Request URL