Message types and samples
Please see Verification API for the full API reference.
Text Message
Content: Text only
Character Limit: Up to 3072 characters
Use Cases: OTP codes, simple alerts
Payload sample
{
"user": {
"msisdn": "+10000000000"
},
"type": "Text",
"content": {
"text": ":wave: Hi Sarah! Just a reminder—your appointment at Wellness Dental is scheduled for tomorrow at 10:30 AM"
}
}
The corresponding message the user will receive:

Sending a Rich Media Message
- Media Types Supported: Images, videos, documents
- File formats: .ogx, .pdf, .aac, .mp3, .mpeg, .mp3, .mp4, .mp4, .3gp, .jpeg, .jpg, .gif, .png, .h263, .m4v, .mp4, .mp4, .mpeg, .webm
- Text Caption: Up to 2,000 UTF-8 characters
- File Size Limits: 100MB
- File URL limit: 2,048 characters
-
Image & text
{
"user": {
"msisdn": "+10000000000"
},
"type": "Image",
"content": {
"url": "https://www.example.com/image.jpg",
"text": "Hi Suzie! Meet Bruno :feet:—one of the many pups looking for a loving home. Every small donation helps us feed, shelter, and care for dogs like him."
}
}
The corresponding message the user will receive:

Video & text
{
"user": {
"msisdn": "+10000000000"
},
"type": "Video",
"content": {
"url": "https://www.example.com/video.mp4",
"text": "Hi Suzie! Meet Bruno :feet:—one of the many pups looking for a loving home. Every small donation helps us feed, shelter, and care for dogs like him."
}
}
The corresponding message the user will receive:

Audio & text
{
"user": {
"msisdn": "+10000000000"
},
"type": "Audio",
"content": {
"url": "https://www.example.com/video.mp4",
"text": "Hi There, this is a Sample RCS Audio Message"
}
}
The corresponding message the user will receive:
File & text
{
"user": {
"msisdn": "+10000000000"
},
"type": "Text",
"content": {
"url": "https://example.com/links/Invoice-october-2025.pdf",
"text": "Hey John! Here’s your monthly invoice for October. Contact our team if you have any questions. Thank you"
}
}
The corresponding message the user will receive:

Updated 21 days ago