Carousel Card

POST

https://sms.fastkyc.in/v1/rcs/messages

A Rich card carousels are ideal for showcasing multiple items such as data plans or devices, allowing users to easily browse and compare different options within a single message.

Carousels combine multiple rich cards into a scrollable format, enabling users to compare items and engage with each card individually.

Carousel specifications

Element	Best Practice
Title	Catchy, under 100 characters, may include emojis for style
Description	Up to 500 characters, but best kept concise (~150–200 for UI fit)
Media	Use HTTPS, optimized image (JPG, PNG)
Suggestions	1–2 per card; include actionable text with a URL or postback

To avoid truncation, keep titles and descriptions as short as possible.

Just like with a standalone rich card, you can include suggestion chips below a carousel to guide the conversation forward.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠400Bad Request

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

cURL

Carousel Rich CardCarousel Rich Card with variables

curl --location --request POST 'https://sms.fastkyc.in/v1/rcs/messages' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "to": "<MOBILE>",
    "agentID": "<AGENT_ID>",
    "message": {
        "templateId": "<TEMPLATE_ID>",
        "templateParams": {
            "carouselParams": [
                {
                    "media": {
                        "contentInfo": {
                            "fileUrl": "<FILE_URL>",
                            "fileName": "<FILE_TYPE>",
                            "mimeType": "<MIME_TYPE>"
                        }
                    }
                },
                {
                    "media": {
                        "contentInfo": {
                            "fileUrl": "<FILE_URL>",
                            "fileName": "<FILE_TYPE>",
                            "mimeType": "<MIME_TYPE>"
                        }
                    }
                }
            ]
        }
    }
}'

Response Example

200 - Success

{
    "message": "1 numbers accepted",
    "data": [
        {
            "messageId": "a8XXXXXX-1bXX-4XXd-b5XX-5dXXXXXX:1",
            "mobile": "+9198XXXXXXXXX",
            "charges": 0.05
        }
    ]
}

Modified at 2025-06-30 06:21:24

Stand Alone Card

Receiving Messages via Webhook