Skip to main content
POST
/
transactional_messages
/
send_rcs_carousel
Send an RCS Carousel
curl --request POST \
  --url https://api.v3.tatango.com/transactional_messages/send_rcs_carousel \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "phoneNumber": "5551234567",
  "webhookUrl": "https://api.example.com/webhooks/rcs",
  "rcsPayload": {
    "cards": [
      {
        "body": {
          "title": "Summer Sale",
          "text": "Save up to 50% on all summer items. Limited time offer!",
          "url": "https://example.com/images/summer-sale.jpg",
          "isVideo": false
        }
      },
      {
        "body": {
          "title": "Winter Collection",
          "text": "Get ready for winter with our latest collection.",
          "url": "https://example.com/images/winter-collection.jpg",
          "isVideo": false
        }
      }
    ]
  },
  "smsFailover": "Check out our latest offers!"
}
'
{
  "message": "RCS carousel message sent successfully",
  "transactionId": "019687e1-1b54-70f4-a68a-60af7fa776f4"
}
RCS Carousels allow you to send multiple rich cards in a single message, creating an interactive sliding experience.RCS Carousel Features:
  • Multiple Cards: Send 1-3 rich cards in a single message
  • Media Support: Images and videos with thumbnails
  • Rich Text: Rich text features: Bold, italic, underline, strikethrough and emojis
  • Fallback: Automatic SMS fallback if RCS delivery fails
Requirements: Valid U.S. phone number with RCS support

Authorizations

​
x-api-key
string
header
required

Your Tatango API key. This is required for all requests to the API. You can find your API key in the Tatango App under My Account -> API -> Create API Key.

Body

application/json

The RCS Carousel message request with SMS fallback.

​
phoneNumber
string
required

The destination phone number. Can be provided in any format (e.g., +1 555-123-4567, (555) 123-4567, 5551234567) but must be a valid U.S. or Canadian phone number.

​
webhookUrl
string
required

URL where webhooks will be sent. Must be a valid HTTPS URL.

Maximum string length: 255
​
rcsPayload
object
required
​
smsFailover
string
required

SMS fallback message content used when primary delivery method fails. Must contain only GSM 7-bit characters.

Required string length: 1 - 160

Response

RCS Carousel message accepted.

​
message
string
required

Success message indicating the request was accepted.

​
transactionId
string
required

Unique transaction identifier for tracking the message.