Rich Communication Services (RCS) is a new, visually appealing messaging channel that offers rich functionalities to enable more engaging customer journeys. RCS is sometimes referred to as the “SMS 2.0”. — 23 operation path(s) and 11 webhook(s) in Infobip's published OpenAPI.
{
"openapi":"3.1.0",
"info":{
"title":"Infobip OpenAPI Specification",
"description":"OpenAPI Specification that contains all public endpoints and webhooks.",
"contact":{
"name":"Infobip support",
"email":"support@infobip.com"
},
"version":"3.210.0",
"x-generatedAt":"2026-07-23T15:23:57.376121732Z"
},
"tags":[
{
"name":"channels",
"description":"Create a perfect customer experience by using the channels your customer already use and love.\n",
"x-type":"category",
"x-displayName":"Channels"
},
{
"name":"rcs",
"description":"Rich Communication Services (RCS) is a new, visually appealing messaging channel that offers rich functionalities to enable more engaging customer journeys. RCS is sometimes referred to as the “SMS 2.0”. It takes everything users and companies already love about SMS—100% reach, reliability, ease of use, security—and builds on this to create an even better method of communication. Through a rich feature set that allows the creation of branded messages incorporating multimedia, suggested reply buttons, barcode delivery, click-through options and more, brands now have a new way to develop relationships through 2-Way communication.\n\n To utilize RCS in combination with other channels, check out [Messages API](https://www.infobip.com/docs/api/platform/messages-api).",
"x-type":"product",
"x-displayName":"RCS"
},
{
"name":"rcs-outbound-messages",
"description":"When you send an RCS message to a phone number belonging to an end user's device you are sending an outbound RCS message.\n",
"x-type":"module",
"x-displayName":"Outbound Messages"
},
{
"name":"rcs-outbound-events",
"description":"When you send an RCS event to a phone number belonging to an end user's device you are sending an outbound RCS event.\n",
"x-type":"module",
"x-displayName":"Outbound Events"
},
{
"name":"rcs-inbound-messages",
"description":"When the end user sends an RCS message from their device to an RCS sender, they have sent an inbound RCS message.\n",
"x-type":"module",
"x-displayName":"Inbound Messages"
},
{
"name":"rcs-inbound-events",
"description":"When the end user interacts with an RCS message — such as typing an answer — these actions generate inbound events that are sent back to the RCS sender.\n",
"x-type":"module",
"x-displayName":"Inbound Events"
},
{
"name":"rcs-logs-and-status-reports",
"description":"Status Reports tell you what happened to the RCS message you have sent, whether it was successfully delivered or failed to be delivered. Logs provide similar information to Status Reports but are available to query for 48hrs.\n",
"x-type":"module",
"x-displayName":"Logs and Status Reports"
},
{
"name":"rcs-capability-check",
"description":"RCS Capability Check feature gives you the possibility to check if some phone number can receive RCS messages \nfrom the specified sender.\n",
"x-type":"module",
"x-displayName":"Capability Check"
},
{
"name":"rcs-service-management",
"description":"RCS Service Management allows you to manage your RCS senders, RCS test numbers, and RCS message templates.\n",
"x-type":"module",
"x-displayName":"Service Management"
},
{
"name":"rcs-sender-management",
"description":"",
"x-type":"section",
"x-displayName":"Sender Management"
},
{
"name":"rcs-test-number-management",
"description":"",
"x-type":"section",
"x-displayName":"Test Number Management"
},
{
"name":"rcs-template-management",
"description":"",
"x-type":"section",
"x-displayName":"Template Management"
}
],
"paths":{
"/rcs/2/messages":{
"post":{
"tags":[
"channels",
"rcs",
"rcs-outbound-messages"
],
"summary":"Send RCS messages",
"description":"Send RCS messages or RCS template messages to multiple recipients. Maximum request size is 10MB. Including some fields will affect [billing type](https://www.infobip.com/docs/rcs/billing-types).",
"externalDocs":{
"description":"Learn more about RCS channel and use cases",
"url":"https://www.infobip.com/docs/rcs"
},
"operationId":"send-rcs-messages",
"requestBody":{
"content":{
"application/json":{
"schema":{
"$ref":"#/components/schemas/b839d8c276f6f1ef62ce2dce758ba402953b31f455d6d08549a7147d79f50d62.RcsMessageRequest"
},
"examples":{
"Basic text message":{
"summary":"Basic text message",
"value":{
"messages":[
{
"sender":"DemoSender",
"destinations":[
{
"to":"441134960001"
}
],
"content":{
"text":"Some text",
"type":"TEXT"
}
}
]
}
},
"Single text message":{
"summary":"Single text message",
"value":{
"messages":[
{
"sender":"DemoSender",
"destinations":[
{
"to":"441134960001"
}
],
"content":{
"text":"Some text",
"suggestions":[
{
"text":"Example text",
"postbackData":"Example postback data",
"type":"REPLY"
}
],
"type":"TEXT"
}
}
]
}
},
"Text message with SMS failover":{
"summary":"Text message with SMS failover",
"value":{
"messages":[
{
"sender":"DemoSender",
"destinations":[
{
"to":"441134960001"
}
],
"content":{
"text":"Some text",
"suggestions":[
{
"text":"Example text",
"postbackData":"Example postback data",
"type":"REPLY"
}
],
"type":"TEXT"
},
"options":{
"platform":{
"entityId":"Example entity id",
"applicationId":"Example application id"
},
"validityPeriod":{
"amount":1,
"timeUnit":"HOURS"
},
"deliveryTimeWindow":{
"days":[
"MONDAY",
"TUESDAY"
],
"from":{
"hour":9,
"minute":0
},
"to":{
"hour":17,
"minute":0
}
},
"campaignReferenceId":"Example campaign id",
"smsFailover":{
"sender":"DemoSender",
"text":"Some failover text",
"validityPeriod":{
"amount":1,
"timeUnit":"HOURS"
}
}
}
}
]
}
},
"Text message with MMS failover":{
"summary":"Text message with MMS failover",
"value":{
"messages":[
{
"sender":"DemoSender",
"destinations":[
{
"to":"441134960001"
}
],
"content":{
"text":"Some text",
"suggestions":[
{
"text":"Example text",
"postbackData":"Example postback data",
"type":"REPLY"
}
],
"type":"TEXT"
},
"options":{
"platform":{
"entityId":"Example entity id",
"applicationId":"Example application id"
},
"validityPeriod":{
"amount":1,
"timeUnit":"HOURS"
},
"deliveryTimeWindow":{
"days":[
"MONDAY",
"TUESDAY"
],
"from":{
"hour":9,
"minute":0
},
"to":{
"hour":17,
"minute":0
}
},
"campaignReferenceId":"Example campaign id",
"mmsFailover":{
"sender":"DemoSender",
"validityPeriod":{
"amount":1,
"timeUnit":"HOURS"
},
"content":{
"title":"Example failover title",
"messageSegments":[
{
"text":"Example failover text",
"type":"TEXT"
}
]
}
}
}
}
]
}
},
"File message":{
"summary":"File message",
"value":{
"messages":[
{
"sender":"DemoSender",
"destinations":[
{
"to":"441134960001"
}
],
"content":{
"file":{
"url":"https://www.example.com/video.mp4"
},
"thumbnail":{
"url":"https://www.example.com/thumbnail.jpg"
},
"suggestions":[
{
"text":"Example text",
"postbackData":"Example postback data",
"type":"REPLY"
}
],
"type":"FILE"
}
}
]
}
},
"Card message":{
"summary":"Card message",
"value":{
"messages":[
{
"sender":"DemoSender",
"destinations":[
{
"to":"441134960001"
}
],
"content":{
"orientation":"HORIZONTAL",
"alignment":"LEFT",
"content":{
"title":"Some title",
"description":"Some description",
"media":{
"file":{
"url":"https://www.example.com/video.mp4"
},
"thumbnail":{
"url":"https://www.example.com/thumbnail.jpg"
},
"height":"TALL"
},
"suggestions":[
{
"text":"Example text",
"postbackData":"Example postback data",
"url":"https://www.example.com/",
"application":"BROWSER",
"type":"OPEN_URL"
},
{
"text":"Example text",
"postbackData":"Example postback data",
"type":"REPLY"
}
]
},
"suggestions":[
{
"text":"Example text",
"postbackData":"Example postback data",
"type":"REPLY"
}
],
"type":"CARD"
}
}
]
}
},
"Card message with URL tracking":{
"summary":"Card message with URL tracking",
"value":{
"messages":[
{
"sender":"DemoSender",
"destinations":[
{
"to":"441134960001"
}
],
"content":{
"orientation":"HORIZONTAL",
"alignment":"LEFT",
"content":{
"title":"Some title",
"description":"Some description",
"media":{
"file":{
"url":"https://www.example.com/video.mp4"
},
"thumbnail":{
"url":"https://www.example.com/thumbnail.jpg"
},
"height":"TALL"
},
"suggestions":[
{
"text":"Example text",
"postbackData":"Example postback data",
"url":"https://www.example.com/",
"application":"BROWSER",
"type":"OPEN_URL"
},
{
"text":"Example text",
"postbackData":"Example postback data",
"type":"REPLY"
}
]
},
"suggestions":[
{
"text":"Example text",
"postbackData":"Example postback data",
"type":"REPLY"
}
],
"type":"CARD"
}
}
],
"options":{
"tracking":{
"shortenUrl":true,
"trackClicks":true,
"trackingUrl":"https://www.example.com/tracking-callback-server",
"removeProtocol":false
}
}
}
},
"Carousel message":{
"summary":"Carousel message",
"value":{
"messages":[
{
"sender":"DemoSender",
"destinations":[
{
"to":"441134960001"
}
],
"content":{
"cardWidth":"MEDIUM",
"contents":[
{
"title":"Some title",
"description":"Some description",
"media":{
"file":{
"url":"https://www.example.com/video.mp4"
},
"thumbnail":{
"url":"https://www.example.com/thumbnail.jpg"
},
"height":"MEDIUM"
},
"suggestions":[
{
"text":"Example text",
"postbackData":"Example postback data",
"url":"https://www.example.com/",
"application":"BROWSER",
"type":"OPEN_URL"
},
{
"text":"Example text",
"postbackData":"Example postback data",
"type":"REPLY"
}
]
},
{
"title":"Another title",
"description":"Another description",
"media":{
"file":{
"url":"https://www.sample.com/video_2.mp4"
},
"thumbnail":{
"url":"https://www.sample.com/thumbnail_2.jpg"
},
"height":"MEDIUM"
},
"suggestions":[
{
"text":"Another example text",
"postbackData":"Another example postback data",
"url":"https://www.sample.com/",
"application":"WEBVIEW",
"webviewViewMode":"FULL",
"type":"OPEN_URL"
},
{
"text":"Another example text",
"postbackData":"Another example postback data",
"type":"REPLY"
}
]
}
],
"suggestions":[
{
"text":"Example text",
"postbackData":"Example postback data",
"type":"REPLY"
}
],
"type":"CAROUSEL"
}
}
]
}
},
"Provider template message":{
"summary":"Provider template message",
"value":{
"messages":[
{
"sender":"DemoSender",
"destinations":[
{
"to":"441134960001"
}
],
"content":{
"templateId":"ExampleTemplateId",
"parameters":[
{
"name":"param1",
"value":"paramValue1"
},
{
"name":"param2",
"value":"paramValue2"
}
],
"type":"PROVIDER_TEMPLATE"
}
}
]
}
},
"Text with different types of suggestions":{
"summary":"Text with different types of suggestions",
"value":{
"messages":[
{
"sender":"DemoSender",
"destinations":[
{
"to":"441134960001"
}
],
"content":{
"text":"Some text",
"suggestions":[
{
"text":"Example reply",
"postbackData":"Example postback data",
"type":"REPLY"
},
{
"text":"Example open URL",
"postbackData":"Example postback data",
"url":"https://www.example.com/",
"application":"WEBVIEW",
"webviewViewMode":"TALL",
"type":"OPEN_URL"
},
{
"text":"Example dial phone",
"postbackData":"Example postback data",
"phoneNumber":"+123456789",
"type":"DIAL_PHONE"
},
{
"text":"Example show location",
"postbackData":"Example postback data",
"latitude":44.95303944321183,
"longitude":13.856468230015984,
"label":"Infobip HQ",
"type":"SHOW_LOCATION"
},
{
"text":"Example request of location",
"postbackData":"Example postback data",
"type":"REQUEST_LOCATION"
},
{
"text":"Example create calendar event",
"postbackData":"Example postback data",
"startTime":"2024-06-14T09:00:00.000+0000",
"endTime":"2024-06-14T10:00:00.000+0000",
"title":"Example title",
"description":"Example description",
"type":"CREATE_CALENDAR_EVENT"
}
],
"type":"TEXT"
}
}
]
}
},
"Ordered messages with SMS failover":{
"summary":"Ordered messages with SMS failover",
"value":{
"messages":[
{
"sender":"DemoSender",
"destinations":[
{
"to":"441134960001"
}
],
"content":{
"text":"First message text",
"type":"TEXT"
},
"options":{
"validityPeriod":{
"amount":1,
"timeUnit":"HOURS"
},
"campaignReferenceId":"Example campaign id",
"smsFailover":{
"sender":"DemoSender",
"text":"Some failover text",
"validityPeriod":{
"amount":1,
"timeUnit":"HOURS"
}
}
}
},
{
"sender":"DemoSender",
"destinations":[
{
"to":"441134960001"
}
],
"content":{
"text":"Second message text",
"type":"TEXT"
},
"options":{
"validityPeriod":{
"amount":1,
"timeUnit":"HOURS"
},
"campaignReferenceId":"Example campaign id"
}
}
],
"options":{
"messageOrdering":{
"respectOrder":true,
"stopOnFailure":true
}
}
}
},
"Ordered messages without failover":{
"summary":"Ordered messages without failover",
"value":{
"messages":[
{
"sender":"DemoSender",
"destinations":[
{
"to":"441134960001"
}
],
"content":{
"text":"First message text",
"type":"TEXT"
},
"options":{
"validityPeriod":{
"amount":1,
"timeUnit":"HOURS"
},
"campaignReferenceId":"Example campaign id"
}
},
{
"sender":"DemoSender",
"destinations":[
{
"to":"441134960001"
}
],
"content":{
"text":"Second message text",
"type":"TEXT"
},
"options":{
"validityPeriod":{
"amount":5,
"timeUnit":"MINUTES"
},
"campaignReferenceId":"Example campaign id"
}
},
{
"sender":"DemoSender",
"destinations":[
{
"to":"441134960001"
}
],
"content":{
"text":"Third message text",
"type":"TEXT"
},
"options":{
"validityPeriod":{
"amount":5,
"timeUnit":"MINUTES"
},
"campaignReferenceId":"Example campaign id"
}
}
],
"options":{
"messageOrdering":{
"respectOrder":true,
"stopOnFailure":true
}
}
}
}
}
}
},
"required":true
},
"responses":{
"200":{
"description":"OK",
"content":{
"application/json":{
"schema":{
"$ref":"#/components/schemas/b839d8c276f6f1ef62ce2dce758ba402953b31f455d6d08549a7147d79f50d62.ResponseEnvelopeMessageResponseMessageResponseDetails"
},
"examples":{
"Success":{
"summary":"Success",
"value":{
"bulkId":"a28dd97c-2222-4fcf-99f1-0b557ed381da",
"messages":[
{
"messageId":"a28dd97c-1ffb-4fcf-99f1-0b557ed381da",
"status":{
"groupId":1,
"groupName":"PENDING",
"id":26,
"name":"PENDING_ACCEPTED",
"description":"Message sent to next instance"
},
"destination":"441134960001"
}
]
}
}
}
}
}
},
"400":{
"description":"Bad Request",
"content":{
"application/json":{
"schema":{
"$ref":"#/components/schemas/ApiError"
},
"examples":{
"Bad request":{
"summary":"Bad request",
"value":{
"errorCode":"E400",
"description":"Request cannot be processed.",
"action":"Check the syntax, violations and adjust the request.",
"violations":[
{
"property":"property.path",
"violation":"Violation message."
}
],
"resources":[]
}
}
}
}
}
},
"401":{
"$ref":"#/components/responses/ApiError401"
},
"403":{
"$ref":"#/components/responses/ApiError403"
},
"500":{
"$ref":"#/components/responses/ApiError500"
}
},
"security":[
{
"IBSSOTokenHeader":[]
},
{
"APIKeyHeader":[]
},
{
"Basic":[]
},
{
"OAuth2":[]
}
],
"x-scopes":[
"message:send",
"rcs:message:send",
"rcs:manage"
]
}
},
"/ott/rcs/1/message":{
"post":{
"tags":[
"channels",
"rcs",
"rcs-outbound-messages"
],
"summary":"Send RCS message",
"description":"Used for sending single RCS messages",
"operationId":"send-rcs-message",
"requestBody":{
"content":{
"application/json":{
"schema":{
"$ref":"#/components/schemas/a09fd2f38320e8e77c07ff55b0f3c0f934582962897bb3b86f1a032582a1cc60.RcsSendRequest"
},
"examples":{
"Text":{
"summary":"Text",
"value":{
"from":"myRcsSender",
"to":"385977666618",
"validityPeriod":15,
"validityPeriodTimeUnit":"MINUTES",
"content":{
"text":"exampleText",
"suggestions":[
{
"text":"exampleText",
"postbackData":"examplePostbackData",
"type":"REPLY"
},
{
"text":"exampleText",
"postbackData":"examplePostbackData",
"url":"www.example.test",
"type":"OPEN_URL"
},
{
"text":"exampleText",
"postbackData":"examplePostbackData",
"phoneNumber":"385977666618",
"type":"DIAL_PHONE"
},
{
"text":"exampleText",
"postbackData":"examplePostbackData",
"latitude":45.793418,
"longitude":15.946297,
"label":"label",
"type":"SHOW_LOCATION"
},
{
"text":"exampleText",
"postbackData":"examplePostbackData",
"type":"REQUEST_LOCATION"
}
],
"type":"TEXT"
},
"notifyUrl":"https://www.example.com/rcs",
"callbackData":"Callback data",
"messageId":"externalMessageId",
"entityId":"entityId",
"applicationId":"applicationId"
}
},
"File":{
"summary":"File",
"value":{
"from":"myRcsSender",
"to":"385977666618",
"validityPeriod":15,
"validityPeriodTimeUnit":"MINUTES",
"content":{
"file":{
"url":"www.example.url"
},
"thumbnail":{
"url":"www.thumbnail.example.url"
},
"type":"FILE"
},
"notifyUrl":"https://www.example.com/rcs",
"callbackData":"Callback data",
"messageId":"externalMessageId",
"entityId":"entityId",
"applicationId":"applicationId"
}
},
"Card":{
"summary":"Card",
"value":{
"from":"myRcsSender",
"to":"385977666618",
"validityPeriod":15,
"validityPeriodTimeUnit":"MINUTES",
"content":{
"orientation":"HORIZONTAL",
"alignment":"LEFT",
"content":{
"title":"title,",
"description":"description",
"media":{
"file":{
"url":"url"
},
"thumbnail":{
"url":"url"
},
"height":"MEDIUM"
}
},
"suggestions":[
{
"text":"exampleText",
"postbackData":"examplePostbackData",
"type":"REPLY"
},
{
"text":"exampleText",
"postbackData":"examplePostbackData",
"url":"www.example.test",
"type":"OPEN_URL"
},
{
"text":"exampleText",
"postbackData":"examplePostbackData",
"phoneNumber":"385977666618",
"type":"DIAL_PHONE"
},
{
"text":"exampleText",
"postbackData":"examplePostbackData",
"latitude":45.793418,
"longitude":15.946297,
"label":"label",
"type":"SHOW_LOCATION"
},
{
"text":"exampleText",
"postbackData":"examplePostbackData",
"type":"REQUEST_LOCATION"
}
],
"type":"CARD"
},
"notifyUrl":"https://www.example.com/rcs",
"callbackData":"Callback data",
"messageId":"externalMessageId",
"entityId":"entityId",
"applicationId":"applicationId"
}
},
"Carousel":{
"summary":"Carousel",
"value":{
"from":"myRcsSender",
"to":"385977666618",
"validityPeriod":15,
"validityPeriodTimeUnit":"MINUTES",
"content":{
"cardWidth":"MEDIUM",
"contents":[
{
"title":"title,",
"description":"description",
"media":{
"file":{
"url":"url"
},
"thumbnail":{
"url":"url"
},
"height":"MEDIUM"
}
}
],
"suggestions":[
{
"text":"exampleText",
"postbackData":"examplePostbackData",
"type":"REPLY"
},
{
"text":"exampleText",
"postbackData":"examplePostbackData",
"url":"www.example.test",
"type":"OPEN_URL"
},
{
"text":"exampleText",
"postbackData":"examplePostbackData",
"phoneNumber":"385977666618",
"type":"DIAL_PHONE"
},
{
"text":"exampleText",
"postbackData":"examplePostbackData",
"latitude":45.793418,
"longitude":15.946297,
"label":"label",
"type":"SHOW_LOCATION"
},
{
"text":"exampleText",
"postbackData":"examplePostbackData",
"type":"REQUEST_LOCATION"
}
],
"type":"CAROUSEL"
},
"notifyUrl":"https://www.example.com/rcs",
"callbackData":"Callback data",
"messageId":"externalMessageId",
"entityId":"entityId",
"applicationId":"applicationId"
}
},
"SMS failover example":{
"summary":"SMS failover example",
"value":{
"from":"myRcsSender",
"to":"385977666618",
"validityPeriod":15,
"validityPeriodTimeUnit":"MINUTES",
"content":{
"text":"exampleText",
"type":"TEXT"
},
"smsFailover":{
"from":"myInfoSmsSender",
"text":"We could not reach you over RCS messaging.",
"validityPeriod":15,
"validityPeriodTimeUnit":"MINUTES"
},
"notifyUrl":"https://www.example.com/rcs",
"callbackData":"Callback data",
"messageId":"externalMessageId",
"entityId":"entityId",
"applicationId":"applicationId"
}
},
"SMS failover regional example":{
"summary":"SMS failover regional example",
"value":{
"from":"myRcsSender",
"to":"385977666618",
"validityPeriod":15,
"validityPeriodTimeUnit":"MINUTES",
"content":{
"text":"exampleText",
"type":"TEXT"
},
"smsFailover":{
"from":"myInfoSmsSender",
"text":"We could not reach you over RCS messaging.",
"validityPeriod":15,
"validityPeriodTimeUnit":"MINUTES",
"regional":{
"indiaDlt":{
"contentTemplateId":"myContentTemplateId",
"principalEntityId":"myPrincipalEntityId"
}
}
},
"notifyUrl":"https://www.example.com/rcs",
"callbackData":"Callback data",
"messageId":"externalMessageId",
"entityId":"entityId",
"applicationId":"applicationId"
}
}
}
}
},
"required":true
},
"responses":{
"200":{
"description":"Successful response",
"content":{
"application/json":{
"schema":{
"$ref":"#/components/schemas/b839d8c276f6f1ef62ce2dce758ba402953b31f455d6d08549a7147d79f50d62.RcsApiResponse"
}
}
}
},
"400":{
"description":"Bad request",
"content":{
"application/json":{
"schema":{
"$ref":"#/components/schemas/7e9cb629dd52a85ce6e062228c85b37a768e3c9da7cd3bd0d9451171d2b14262.ApiException"
},
"examples":{
"Bad request":{
"summary":"Bad request",
"value":{
"requestError":{
"serviceException":{
"messageId":"BAD_REQUEST",
"text":"Bad request"
}
}
}
}
}
}
}
},
"401":{
"$ref":"#/components/responses/ApiException401"
},
"403":{
"$ref":"#/components/responses/ApiException403"
},
"500":{
"$ref":"#/components/responses/ApiException500"
}
},
"d
# --- truncated at 32 KB (463 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/infobip/refs/heads/main/openapi/infobip-rcs-openapi.json