> For the complete documentation index, see [llms.txt](https://docs.360dialog.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.360dialog.com/docs/messaging-api/api-reference/rcs.md).

# RCS

Endpoints for RCS integration

## Notify RCS Capability Result (Async)

> Asynchronously notify the result of a capability check for an RCS recipient.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.51.5"},"tags":[{"name":"RCS","description":"Endpoints for RCS integration"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"capability.RcsCapabilityCheckAsyncRequest":{"properties":{"notifyContentType":{"description":"NotifyContentType sets the callback content type.","enum":["application/json","application/xml"],"type":"string"},"notifyUrl":{"description":"NotifyUrl is the callback URL for the async result. If empty, the subscription webhook URL is used.","type":"string"},"phoneNumbers":{"description":"PhoneNumbers is the list of numbers to check (up to 10,000 for async).","items":{"type":"string"},"type":"array","uniqueItems":false},"sender":{"type":"string"}},"type":"object"},"capability.RcsCapabilityCheckAsyncResponse":{"properties":{"bulkId":{"description":"BulkId uniquely identifies this async check request.","type":"string"},"capabilityCheckRequestStates":{"items":{"$ref":"#/components/schemas/capability.RcsCapabilityCheckRequestState"},"type":"array","uniqueItems":false}},"type":"object"},"capability.RcsCapabilityCheckRequestState":{"properties":{"messageId":{"type":"string"},"phoneNumber":{"type":"string"},"status":{"description":"Status is the current processing state of the capability check request.","enum":["PENDING_TIME_VIOLATION","DELIVERED_TO_OPERATOR","PENDING_WAITING_DELIVERY","UNDELIVERABLE_REJECTED_OPERATOR","DELIVERED_TO_HANDSET","REJECTED_NETWORK","PENDING_ENROUTE","REJECTED_PREFIX_MISSING","UNDELIVERABLE_NOT_DELIVERED","REJECTED_DND","REJECTED_SOURCE","REJECTED_NOT_ENOUGH_CREDITS","REJECTED_SENDER","REJECTED_DESTINATION","EXPIRED_EXPIRED","REJECTED_NOT_REACHABLE","REJECTED_PREPAID_PACKAGE_EXPIRED","REJECTED_DESTINATION_NOT_REGISTERED","REJECTED_ROUTE_NOT_AVAILABLE","REJECTED_FLOODING_FILTER","REJECTED_SYSTEM_ERROR","EXPIRED_UNKNOWN","REJECTED_DUPLICATE_MESSAGE_ID","REJECTED_INVALID_UDH","REJECTED_MESSAGE_TOO_LONG","REJECTED_NOT_SENT","EXPIRED_DLR_UNKNOWN","MO_DELIVERED","UNDELIVERABLE_NOT_SENT","MISSING_TO","INVALID_DESTINATION_ADDRESS","CONCATENATED_MESSAGE_TOO_LONG","REJECTED_MONTHLY_LIMIT_REACHED","REJECTED_SMPP_SESSION_CLOSED","INVALID_SUBACCOUNT_NAME","REJECTED_GATEWAY_DATA_TOO_LONG","INVALID_COMPANY_ID","REJECTED_INVALID_TRACKING_DATA","REJECTED_INVALID_COUNT","REJECTED_FREE_TRIAL_EXCEEDED","REJECTED_SUBSCRIPTION_PLAN_NOT_ACTIVE","SIM_SWAP_DETECTED","DEACTIVATED_LIST","INVALID_CLIENT_NETWORK","CURRENCY_CHANGE_IN_PROGRESS","REJECTED_UNREACHABLE_DESTINATION","SIGNALS_BLOCKED","VOLUMETRIC_BLOCKED","REJECTED_BLOCKED_TEMPLATE","REJECTED_INVALID_PLATFORM_PARAMETERS","REJECTED_SHORT_DOMAIN_NOT_VERIFIED","REJECTED_10DLC_LIMIT_REACHED","REJECTED_INVALID_BYO_EXTERNAL_ID"],"type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/capability-check/notify":{"post":{"description":"Asynchronously notify the result of a capability check for an RCS recipient.","operationId":"post-rcs-capability-check-notify","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/capability.RcsCapabilityCheckAsyncRequest","summary":"requestBody","description":"Capability notify request"}}},"description":"Capability notify request","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/capability.RcsCapabilityCheckAsyncResponse"}}},"description":"Notification accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Bad request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Rate limit exceeded"}},"summary":"Notify RCS Capability Result (Async)","tags":["RCS"]}}}}
```

## Query RCS Capability (Sync)

> Synchronously check whether a recipient's device supports RCS.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.51.5"},"tags":[{"name":"RCS","description":"Endpoints for RCS integration"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"capability.RcsCapabilityCheckSyncRequest":{"properties":{"phoneNumbers":{"description":"PhoneNumbers is the list of numbers to check (1–5 for sync).","items":{"type":"string"},"type":"array","uniqueItems":false},"sender":{"type":"string"}},"type":"object"},"capability.RcsCapabilityCheckSyncResponse":{"properties":{"capabilityCheckResults":{"items":{"$ref":"#/components/schemas/capability.RcsCapabilityCheckResult"},"type":"array","uniqueItems":false}},"type":"object"},"capability.RcsCapabilityCheckResult":{"properties":{"code":{"enum":["CAPABLE","NOT_CAPABLE"],"type":"string"},"messageId":{"type":"string"},"phoneNumber":{"type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/capability-check/query":{"post":{"description":"Synchronously check whether a recipient's device supports RCS.","operationId":"post-rcs-capability-check-query","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/capability.RcsCapabilityCheckSyncRequest","summary":"requestBody","description":"Capability check request"}}},"description":"Capability check request","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/capability.RcsCapabilityCheckSyncResponse"}}},"description":"Capability check result"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Bad request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Rate limit exceeded"}},"summary":"Query RCS Capability (Sync)","tags":["RCS"]}}}}
```

## Push RCS Event

> Push an inbound or delivery status RCS event.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.51.5"},"tags":[{"name":"RCS","description":"Endpoints for RCS integration"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"messaging.RcsEventRequest":{"properties":{"events":{"items":{"$ref":"#/components/schemas/messaging.RcsEvent"},"type":"array","uniqueItems":false}},"type":"object"},"messaging.RcsEvent":{"properties":{"content":{"$ref":"#/components/schemas/messaging.RcsEventContent"},"destinations":{"items":{"$ref":"#/components/schemas/messaging.RcsEventDest"},"type":"array","uniqueItems":false},"options":{"$ref":"#/components/schemas/messaging.RcsEventOptions"},"sender":{"type":"string"}},"type":"object"},"messaging.RcsEventContent":{"properties":{"messageId":{"description":"MessageId is required for SEEN events to identify the message that was read.","type":"string"},"type":{"description":"Type is one of: SEEN, TYPING_INDICATOR","enum":["SEEN","TYPING_INDICATOR"],"type":"string"}},"type":"object"},"messaging.RcsEventDest":{"properties":{"to":{"type":"string"}},"type":"object"},"messaging.RcsEventOptions":{"properties":{"platform":{"$ref":"#/components/schemas/messaging.RcsPlatform"}},"type":"object"},"messaging.RcsPlatform":{"properties":{"applicationId":{"type":"string"},"entityId":{"type":"string"}},"type":"object"},"messaging.RcsSendMessageResponse":{"properties":{"bulkId":{"description":"BulkId is the unique ID for the bulk request, used to fetch reports/logs.","type":"string"},"messages":{"items":{"$ref":"#/components/schemas/messaging.RcsMessageSendResult"},"type":"array","uniqueItems":false}},"type":"object"},"messaging.RcsMessageSendResult":{"properties":{"messageId":{"type":"string"},"status":{"$ref":"#/components/schemas/messaging.RcsMessageStatus"},"to":{"type":"string"}},"type":"object"},"messaging.RcsMessageStatus":{"properties":{"action":{"type":"string"},"description":{"type":"string"},"groupId":{"type":"integer"},"groupName":{"type":"string"},"id":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/events":{"post":{"description":"Push an inbound or delivery status RCS event.","operationId":"post-rcs-events","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/messaging.RcsEventRequest","summary":"requestBody","description":"RCS event request"}}},"description":"RCS event request","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/messaging.RcsSendMessageResponse"}}},"description":"Event accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Bad request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Rate limit exceeded"}},"summary":"Push RCS Event","tags":["RCS"]}}}}
```

## Get RCS Message Logs

> Retrieve message logs for RCS messages sent by this number. Results are always scoped to the number's own sender and messages.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.51.5"},"tags":[{"name":"RCS","description":"Endpoints for RCS integration"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"reports.RcsMessageLogs":{"properties":{"cursor":{"$ref":"#/components/schemas/reports.RcsCursorPageInfo"},"results":{"items":{"$ref":"#/components/schemas/reports.RcsMessageLog"},"type":"array","uniqueItems":false}},"type":"object"},"reports.RcsCursorPageInfo":{"properties":{"limit":{"type":"integer"},"nextCursor":{"description":"NextCursor is the value to pass as `cursor` in the next request.","type":"string"}},"type":"object"},"reports.RcsMessageLog":{"properties":{"bulkId":{"type":"string"},"content":{"description":"Content holds the original message content (polymorphic).","type":"object"},"destination":{"type":"string"},"doneAt":{"type":"string"},"error":{"$ref":"#/components/schemas/reports.RcsReportError"},"messageCount":{"type":"integer"},"messageId":{"type":"string"},"price":{"$ref":"#/components/schemas/reports.RcsPrice"},"sender":{"type":"string"},"sentAt":{"type":"string"},"status":{"$ref":"#/components/schemas/reports.RcsReportStatus"}},"type":"object"},"reports.RcsReportError":{"properties":{"description":{"type":"string"},"groupId":{"type":"integer"},"groupName":{"type":"string"},"id":{"type":"integer"},"name":{"type":"string"},"permanent":{"type":"boolean"}},"type":"object"},"reports.RcsPrice":{"properties":{"currency":{"description":"Currency is the ISO 4217 code of PricePerMessage.","type":"string"},"pricePerMessage":{"description":"PricePerMessage is the client's own country rate for one message (no markup).","type":"number"}},"type":"object"},"reports.RcsReportStatus":{"properties":{"action":{"type":"string"},"description":{"type":"string"},"groupId":{"type":"integer"},"groupName":{"type":"string"},"id":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/logs":{"get":{"description":"Retrieve message logs for RCS messages sent by this number. Results are always scoped to the number's own sender and messages.","operationId":"get-rcs-logs","parameters":[{"description":"Sender ID. Defaults to the number's configured RCS sender; any other sender is rejected with 401","in":"query","name":"sender","schema":{"type":"string"}},{"description":"Recipient number","in":"query","name":"destination","schema":{"type":"string"}},{"description":"Bulk ID to filter by","in":"query","name":"bulkId","schema":{"type":"string"}},{"description":"Message ID to filter by","in":"query","name":"messageId","schema":{"type":"string"}},{"description":"General status (e.g. DELIVERED, PENDING)","in":"query","name":"generalStatus","schema":{"type":"string"}},{"description":"Filter logs sent after this timestamp (ISO 8601)","in":"query","name":"sentSince","schema":{"type":"string"}},{"description":"Filter logs sent before this timestamp (ISO 8601)","in":"query","name":"sentUntil","schema":{"type":"string"}},{"description":"Maximum number of logs to return","in":"query","name":"limit","schema":{"type":"integer"}},{"description":"Campaign reference ID to filter by","in":"query","name":"campaignReferenceId","schema":{"type":"string"}},{"description":"Use cursor-based pagination","in":"query","name":"useCursor","schema":{"type":"boolean"}},{"description":"Cursor value for next page (from previous response)","in":"query","name":"cursor","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/reports.RcsMessageLogs"}}},"description":"Message logs"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized or sender mismatch"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"RCS not configured for this number"}},"summary":"Get RCS Message Logs","tags":["RCS"]}}}}
```

## Send RCS Message

> Send an RCS message. The sender of each message must match the number's configured RCS sender. smsFailover, mmsFailover and regional properties are not supported and are removed before the message is sent.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.51.5"},"tags":[{"name":"RCS","description":"Endpoints for RCS integration"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"messaging.RcsMessageRequest":{"properties":{"messages":{"description":"Messages is a list of RCS messages to send (supports bulk).","items":{"$ref":"#/components/schemas/messaging.RcsMessage"},"type":"array","uniqueItems":false},"options":{"$ref":"#/components/schemas/messaging.RcsRequestOptions"}},"type":"object"},"messaging.RcsMessage":{"properties":{"content":{"$ref":"#/components/schemas/messaging.RcsOutboundContent"},"destinations":{"items":{"$ref":"#/components/schemas/messaging.RcsMessageDestination"},"type":"array","uniqueItems":false},"options":{"$ref":"#/components/schemas/messaging.RcsMessageOptions"},"sender":{"description":"Sender is the RCS sender ID. Required; must match the number's configured RCS sender.","type":"string"}},"type":"object"},"messaging.RcsOutboundContent":{"properties":{"alignment":{"description":"CARD: media alignment within the card.","enum":["LEFT","RIGHT"],"type":"string"},"cardWidth":{"description":"CAROUSEL: width of each card.","enum":["SMALL","MEDIUM"],"type":"string"},"content":{"$ref":"#/components/schemas/messaging.RcsOutboundCardBody","description":"CARD: the single card body (title, description, media, suggestions)."},"contents":{"description":"CAROUSEL: the list of card bodies (2–10 cards).","items":{"$ref":"#/components/schemas/messaging.RcsOutboundCardBody"},"type":"array","uniqueItems":false},"file":{"$ref":"#/components/schemas/messaging.RcsOutboundFile","description":"FILE: the media file to send."},"language":{"description":"PROVIDER_TEMPLATE: BCP-47 language tag.","type":"string"},"orientation":{"description":"CARD: card orientation.","enum":["HORIZONTAL","VERTICAL"],"type":"string"},"placeholders":{"additionalProperties":{"type":"string"},"description":"PROVIDER_TEMPLATE: named parameter values for the template.","type":"object"},"suggestions":{"description":"TEXT, FILE, CARD, CAROUSEL: action chips shown below the message.","items":{"$ref":"#/components/schemas/messaging.RcsOutboundSuggestion"},"type":"array","uniqueItems":false},"templateId":{"description":"PROVIDER_TEMPLATE: the template identifier.","type":"string"},"text":{"description":"TEXT: message body.","type":"string"},"type":{"enum":["TEXT","FILE","CARD","CAROUSEL","PROVIDER_TEMPLATE"],"type":"string"}},"type":"object"},"messaging.RcsOutboundCardBody":{"properties":{"description":{"type":"string"},"media":{"$ref":"#/components/schemas/messaging.RcsOutboundMedia"},"suggestions":{"items":{"$ref":"#/components/schemas/messaging.RcsOutboundSuggestion"},"type":"array","uniqueItems":false},"title":{"type":"string"}},"type":"object"},"messaging.RcsOutboundMedia":{"properties":{"file":{"$ref":"#/components/schemas/messaging.RcsOutboundFile"},"height":{"description":"Height controls the media display size.","enum":["SHORT","MEDIUM","TALL"],"type":"string"},"thumbnail":{"$ref":"#/components/schemas/messaging.RcsOutboundFile"}},"type":"object"},"messaging.RcsOutboundFile":{"properties":{"url":{"type":"string"}},"type":"object"},"messaging.RcsOutboundSuggestion":{"properties":{"application":{"enum":["BROWSER","WEBVIEW"],"type":"string"},"label":{"type":"string"},"latitude":{"description":"SHOW_LOCATION","type":"number"},"longitude":{"type":"number"},"phoneNumber":{"description":"DIAL_PHONE","type":"string"},"postbackData":{"type":"string"},"text":{"type":"string"},"type":{"enum":["REPLY","OPEN_URL","DIAL_PHONE","SHOW_LOCATION","REQUEST_LOCATION","CREATE_CALENDAR_EVENT"],"type":"string"},"url":{"description":"OPEN_URL","type":"string"},"webviewViewMode":{"enum":["HALF","FULL","TALL"],"type":"string"}},"type":"object"},"messaging.RcsMessageDestination":{"properties":{"to":{"type":"string"}},"type":"object"},"messaging.RcsMessageOptions":{"properties":{"campaignReferenceId":{"type":"string"},"validityPeriod":{"$ref":"#/components/schemas/messaging.RcsValidityPeriod"}},"type":"object"},"messaging.RcsValidityPeriod":{"properties":{"amount":{"description":"Amount is the numeric value of the validity period (max 48 h).","type":"integer"},"timeUnit":{"enum":["SECONDS","MINUTES","HOURS"],"type":"string"}},"type":"object"},"messaging.RcsRequestOptions":{"properties":{"messageOrdering":{"$ref":"#/components/schemas/messaging.RcsMessageOrdering"},"schedule":{"$ref":"#/components/schemas/messaging.RcsSchedule"},"tracking":{"$ref":"#/components/schemas/messaging.RcsUrlTracking"}},"type":"object"},"messaging.RcsMessageOrdering":{"properties":{"respectOrder":{"type":"boolean"},"stopOnFailure":{"type":"boolean"}},"type":"object"},"messaging.RcsSchedule":{"properties":{"bulkId":{"description":"BulkId overrides the auto-generated bulk ID for the request.","type":"string"},"sendAt":{"description":"SendAt schedules the message for a future time (ISO 8601, max 180 days out).","type":"string"}},"type":"object"},"messaging.RcsUrlTracking":{"properties":{"customDomain":{"type":"string"},"removeProtocol":{"type":"boolean"},"shortenUrl":{"type":"boolean"},"trackClicks":{"type":"boolean"},"trackingUrl":{"type":"string"}},"type":"object"},"messaging.RcsSendMessageResponse":{"properties":{"bulkId":{"description":"BulkId is the unique ID for the bulk request, used to fetch reports/logs.","type":"string"},"messages":{"items":{"$ref":"#/components/schemas/messaging.RcsMessageSendResult"},"type":"array","uniqueItems":false}},"type":"object"},"messaging.RcsMessageSendResult":{"properties":{"messageId":{"type":"string"},"status":{"$ref":"#/components/schemas/messaging.RcsMessageStatus"},"to":{"type":"string"}},"type":"object"},"messaging.RcsMessageStatus":{"properties":{"action":{"type":"string"},"description":{"type":"string"},"groupId":{"type":"integer"},"groupName":{"type":"string"},"id":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/messages":{"post":{"description":"Send an RCS message. The sender of each message must match the number's configured RCS sender. smsFailover, mmsFailover and regional properties are not supported and are removed before the message is sent.","operationId":"post-rcs-messages","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/messaging.RcsMessageRequest","summary":"requestBody","description":"RCS message request"}}},"description":"RCS message request","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/messaging.RcsSendMessageResponse"}}},"description":"Message accepted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Bad request or missing sender"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized or sender mismatch"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Rate limit exceeded"}},"summary":"Send RCS Message","tags":["RCS"]}}}}
```

## Get RCS Delivery Reports

> Retrieve delivery reports for RCS messages sent by this number. Results are always scoped to the number's own messages.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.51.5"},"tags":[{"name":"RCS","description":"Endpoints for RCS integration"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"reports.RcsDeliveryReports":{"properties":{"results":{"items":{"$ref":"#/components/schemas/reports.RcsDeliveryReport"},"type":"array","uniqueItems":false}},"type":"object"},"reports.RcsDeliveryReport":{"properties":{"bulkId":{"type":"string"},"doneAt":{"type":"string"},"error":{"$ref":"#/components/schemas/reports.RcsReportError"},"messageCount":{"type":"integer"},"messageId":{"type":"string"},"price":{"$ref":"#/components/schemas/reports.RcsPrice"},"sender":{"type":"string"},"sentAt":{"type":"string"},"status":{"$ref":"#/components/schemas/reports.RcsReportStatus"},"to":{"type":"string"}},"type":"object"},"reports.RcsReportError":{"properties":{"description":{"type":"string"},"groupId":{"type":"integer"},"groupName":{"type":"string"},"id":{"type":"integer"},"name":{"type":"string"},"permanent":{"type":"boolean"}},"type":"object"},"reports.RcsPrice":{"properties":{"currency":{"description":"Currency is the ISO 4217 code of PricePerMessage.","type":"string"},"pricePerMessage":{"description":"PricePerMessage is the client's own country rate for one message (no markup).","type":"number"}},"type":"object"},"reports.RcsReportStatus":{"properties":{"action":{"type":"string"},"description":{"type":"string"},"groupId":{"type":"integer"},"groupName":{"type":"string"},"id":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/reports":{"get":{"description":"Retrieve delivery reports for RCS messages sent by this number. Results are always scoped to the number's own messages.","operationId":"get-rcs-reports","parameters":[{"description":"Unique bulk ID for which reports are requested","in":"query","name":"bulkId","schema":{"type":"string"}},{"description":"Unique message ID for which a report is requested","in":"query","name":"messageId","schema":{"type":"string"}},{"description":"Maximum number of reports to return","in":"query","name":"limit","schema":{"type":"integer"}},{"description":"Campaign reference ID used to further filter the result","in":"query","name":"campaignReferenceId","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/reports.RcsDeliveryReports"}}},"description":"Delivery reports"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"RCS not configured for this number"}},"summary":"Get RCS Delivery Reports","tags":["RCS"]}}}}
```

## List RCS Templates

> List all RCS templates for the configured sender.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.51.5"},"tags":[{"name":"RCS","description":"Endpoints for RCS integration"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"templates.RcsTemplate":{"properties":{"content":{"$ref":"#/components/schemas/templates.RcsTemplateContent"},"lastUpdate":{"type":"string"},"name":{"type":"string"},"status":{"enum":["PENDING","APPROVED","REJECTED","SUSPENDED","APPROVED_IN_PROGRESS","APPROVED_PARTIALLY"],"type":"string"},"type":{"enum":["TEXT","CARD","CAROUSEL","TEXT_WITH_PDF"],"type":"string"}},"type":"object"},"templates.RcsTemplateContent":{"properties":{"alignment":{"description":"CARD only: media alignment within the card.","enum":["LEFT","RIGHT"],"type":"string"},"cardWidth":{"description":"CAROUSEL only: width of each card.","enum":["SMALL","MEDIUM"],"type":"string"},"content":{"$ref":"#/components/schemas/templates.RcsTemplateCardBody","description":"CARD only: the single card body."},"contents":{"description":"CAROUSEL only: the list of card bodies (2–10 cards).","items":{"$ref":"#/components/schemas/templates.RcsTemplateCardBody"},"type":"array","uniqueItems":false},"messageOrder":{"description":"TEXT_WITH_PDF only: order of text and PDF in the message.","enum":["TEXT_MESSAGE_AT_TOP","TEXT_MESSAGE_AT_BOTTOM"],"type":"string"},"orientation":{"description":"CARD only: card orientation.","enum":["HORIZONTAL","VERTICAL"],"type":"string"},"suggestions":{"items":{"$ref":"#/components/schemas/templates.RcsTemplateSuggestion"},"type":"array","uniqueItems":false},"text":{"description":"TEXT and TEXT_WITH_PDF: the message body text. Supports {{parameter}} placeholders.","type":"string"},"type":{"enum":["TEXT","CARD","CAROUSEL","TEXT_WITH_PDF"],"type":"string"},"url":{"description":"TEXT_WITH_PDF only: publicly accessible URL of the PDF file.","type":"string"}},"type":"object"},"templates.RcsTemplateCardBody":{"properties":{"description":{"type":"string"},"media":{"$ref":"#/components/schemas/templates.RcsTemplateMedia"},"suggestions":{"items":{"$ref":"#/components/schemas/templates.RcsTemplateSuggestion"},"type":"array","uniqueItems":false},"title":{"type":"string"}},"type":"object"},"templates.RcsTemplateMedia":{"properties":{"file":{"$ref":"#/components/schemas/templates.RcsTemplateFile"},"height":{"enum":["SHORT","MEDIUM","TALL"],"type":"string"}},"type":"object"},"templates.RcsTemplateFile":{"properties":{"url":{"type":"string"}},"type":"object"},"templates.RcsTemplateSuggestion":{"properties":{"application":{"enum":["BROWSER","WEBVIEW"],"type":"string"},"label":{"type":"string"},"latitude":{"description":"SHOW_LOCATION","type":"number"},"longitude":{"type":"number"},"phoneNumber":{"description":"DIAL_PHONE","type":"string"},"postbackData":{"type":"string"},"text":{"type":"string"},"type":{"enum":["REPLY","OPEN_URL","DIAL_PHONE","SHOW_LOCATION","REQUEST_LOCATION","CREATE_CALENDAR_EVENT"],"type":"string"},"url":{"description":"OPEN_URL","type":"string"},"webviewViewMode":{"enum":["HALF","FULL","TALL"],"type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/senders/{sender}/templates":{"get":{"description":"List all RCS templates for the configured sender.","operationId":"get-rcs-sender-templates","parameters":[{"description":"RCS sender (must match configured sender)","in":"path","name":"sender","required":true,"schema":{"type":"string"}},{"description":"Filter templates by status (e.g. APPROVED, PENDING)","in":"query","name":"status","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/templates.RcsTemplate"},"type":"array"}}},"description":"Templates retrieved"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Sender mismatch"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"}},"summary":"List RCS Templates","tags":["RCS"]}}}}
```

## Create RCS Template

> Create a new RCS template for the configured sender.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.51.5"},"tags":[{"name":"RCS","description":"Endpoints for RCS integration"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"templates.RcsCreateTemplateRequest":{"properties":{"content":{"$ref":"#/components/schemas/templates.RcsTemplateContent"},"providers":{"description":"Providers lists the providers to register the template with.\nDefaults to all providers available for the sender if empty.","items":{"type":"string"},"type":"array","uniqueItems":false},"templateName":{"description":"TemplateName is the unique name for the new template (1–20 chars).","type":"string"}},"type":"object"},"templates.RcsTemplateContent":{"properties":{"alignment":{"description":"CARD only: media alignment within the card.","enum":["LEFT","RIGHT"],"type":"string"},"cardWidth":{"description":"CAROUSEL only: width of each card.","enum":["SMALL","MEDIUM"],"type":"string"},"content":{"$ref":"#/components/schemas/templates.RcsTemplateCardBody","description":"CARD only: the single card body."},"contents":{"description":"CAROUSEL only: the list of card bodies (2–10 cards).","items":{"$ref":"#/components/schemas/templates.RcsTemplateCardBody"},"type":"array","uniqueItems":false},"messageOrder":{"description":"TEXT_WITH_PDF only: order of text and PDF in the message.","enum":["TEXT_MESSAGE_AT_TOP","TEXT_MESSAGE_AT_BOTTOM"],"type":"string"},"orientation":{"description":"CARD only: card orientation.","enum":["HORIZONTAL","VERTICAL"],"type":"string"},"suggestions":{"items":{"$ref":"#/components/schemas/templates.RcsTemplateSuggestion"},"type":"array","uniqueItems":false},"text":{"description":"TEXT and TEXT_WITH_PDF: the message body text. Supports {{parameter}} placeholders.","type":"string"},"type":{"enum":["TEXT","CARD","CAROUSEL","TEXT_WITH_PDF"],"type":"string"},"url":{"description":"TEXT_WITH_PDF only: publicly accessible URL of the PDF file.","type":"string"}},"type":"object"},"templates.RcsTemplateCardBody":{"properties":{"description":{"type":"string"},"media":{"$ref":"#/components/schemas/templates.RcsTemplateMedia"},"suggestions":{"items":{"$ref":"#/components/schemas/templates.RcsTemplateSuggestion"},"type":"array","uniqueItems":false},"title":{"type":"string"}},"type":"object"},"templates.RcsTemplateMedia":{"properties":{"file":{"$ref":"#/components/schemas/templates.RcsTemplateFile"},"height":{"enum":["SHORT","MEDIUM","TALL"],"type":"string"}},"type":"object"},"templates.RcsTemplateFile":{"properties":{"url":{"type":"string"}},"type":"object"},"templates.RcsTemplateSuggestion":{"properties":{"application":{"enum":["BROWSER","WEBVIEW"],"type":"string"},"label":{"type":"string"},"latitude":{"description":"SHOW_LOCATION","type":"number"},"longitude":{"type":"number"},"phoneNumber":{"description":"DIAL_PHONE","type":"string"},"postbackData":{"type":"string"},"text":{"type":"string"},"type":{"enum":["REPLY","OPEN_URL","DIAL_PHONE","SHOW_LOCATION","REQUEST_LOCATION","CREATE_CALENDAR_EVENT"],"type":"string"},"url":{"description":"OPEN_URL","type":"string"},"webviewViewMode":{"enum":["HALF","FULL","TALL"],"type":"string"}},"type":"object"},"templates.RcsTemplate":{"properties":{"content":{"$ref":"#/components/schemas/templates.RcsTemplateContent"},"lastUpdate":{"type":"string"},"name":{"type":"string"},"status":{"enum":["PENDING","APPROVED","REJECTED","SUSPENDED","APPROVED_IN_PROGRESS","APPROVED_PARTIALLY"],"type":"string"},"type":{"enum":["TEXT","CARD","CAROUSEL","TEXT_WITH_PDF"],"type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/senders/{sender}/templates":{"post":{"description":"Create a new RCS template for the configured sender.","operationId":"post-rcs-sender-templates","parameters":[{"description":"RCS sender (must match configured sender)","in":"path","name":"sender","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/templates.RcsCreateTemplateRequest","summary":"requestBody","description":"Template definition"}}},"description":"Template definition","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/templates.RcsTemplate"}}},"description":"Template created"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Sender mismatch or bad request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"}},"summary":"Create RCS Template","tags":["RCS"]}}}}
```

## Get RCS Template

> Retrieve details of a specific RCS template.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.51.5"},"tags":[{"name":"RCS","description":"Endpoints for RCS integration"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"templates.RcsTemplate":{"properties":{"content":{"$ref":"#/components/schemas/templates.RcsTemplateContent"},"lastUpdate":{"type":"string"},"name":{"type":"string"},"status":{"enum":["PENDING","APPROVED","REJECTED","SUSPENDED","APPROVED_IN_PROGRESS","APPROVED_PARTIALLY"],"type":"string"},"type":{"enum":["TEXT","CARD","CAROUSEL","TEXT_WITH_PDF"],"type":"string"}},"type":"object"},"templates.RcsTemplateContent":{"properties":{"alignment":{"description":"CARD only: media alignment within the card.","enum":["LEFT","RIGHT"],"type":"string"},"cardWidth":{"description":"CAROUSEL only: width of each card.","enum":["SMALL","MEDIUM"],"type":"string"},"content":{"$ref":"#/components/schemas/templates.RcsTemplateCardBody","description":"CARD only: the single card body."},"contents":{"description":"CAROUSEL only: the list of card bodies (2–10 cards).","items":{"$ref":"#/components/schemas/templates.RcsTemplateCardBody"},"type":"array","uniqueItems":false},"messageOrder":{"description":"TEXT_WITH_PDF only: order of text and PDF in the message.","enum":["TEXT_MESSAGE_AT_TOP","TEXT_MESSAGE_AT_BOTTOM"],"type":"string"},"orientation":{"description":"CARD only: card orientation.","enum":["HORIZONTAL","VERTICAL"],"type":"string"},"suggestions":{"items":{"$ref":"#/components/schemas/templates.RcsTemplateSuggestion"},"type":"array","uniqueItems":false},"text":{"description":"TEXT and TEXT_WITH_PDF: the message body text. Supports {{parameter}} placeholders.","type":"string"},"type":{"enum":["TEXT","CARD","CAROUSEL","TEXT_WITH_PDF"],"type":"string"},"url":{"description":"TEXT_WITH_PDF only: publicly accessible URL of the PDF file.","type":"string"}},"type":"object"},"templates.RcsTemplateCardBody":{"properties":{"description":{"type":"string"},"media":{"$ref":"#/components/schemas/templates.RcsTemplateMedia"},"suggestions":{"items":{"$ref":"#/components/schemas/templates.RcsTemplateSuggestion"},"type":"array","uniqueItems":false},"title":{"type":"string"}},"type":"object"},"templates.RcsTemplateMedia":{"properties":{"file":{"$ref":"#/components/schemas/templates.RcsTemplateFile"},"height":{"enum":["SHORT","MEDIUM","TALL"],"type":"string"}},"type":"object"},"templates.RcsTemplateFile":{"properties":{"url":{"type":"string"}},"type":"object"},"templates.RcsTemplateSuggestion":{"properties":{"application":{"enum":["BROWSER","WEBVIEW"],"type":"string"},"label":{"type":"string"},"latitude":{"description":"SHOW_LOCATION","type":"number"},"longitude":{"type":"number"},"phoneNumber":{"description":"DIAL_PHONE","type":"string"},"postbackData":{"type":"string"},"text":{"type":"string"},"type":{"enum":["REPLY","OPEN_URL","DIAL_PHONE","SHOW_LOCATION","REQUEST_LOCATION","CREATE_CALENDAR_EVENT"],"type":"string"},"url":{"description":"OPEN_URL","type":"string"},"webviewViewMode":{"enum":["HALF","FULL","TALL"],"type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/senders/{sender}/templates/{templateName}":{"get":{"description":"Retrieve details of a specific RCS template.","operationId":"get-rcs-sender-template","parameters":[{"description":"RCS sender (must match configured sender)","in":"path","name":"sender","required":true,"schema":{"type":"string"}},{"description":"Template name","in":"path","name":"templateName","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/templates.RcsTemplate"}}},"description":"Template retrieved"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Sender mismatch"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"}},"summary":"Get RCS Template","tags":["RCS"]}}}}
```

## Update RCS Template

> Update an existing RCS template.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.51.5"},"tags":[{"name":"RCS","description":"Endpoints for RCS integration"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"templates.RcsUpdateTemplateRequest":{"properties":{"content":{"$ref":"#/components/schemas/templates.RcsTemplateContent"}},"type":"object"},"templates.RcsTemplateContent":{"properties":{"alignment":{"description":"CARD only: media alignment within the card.","enum":["LEFT","RIGHT"],"type":"string"},"cardWidth":{"description":"CAROUSEL only: width of each card.","enum":["SMALL","MEDIUM"],"type":"string"},"content":{"$ref":"#/components/schemas/templates.RcsTemplateCardBody","description":"CARD only: the single card body."},"contents":{"description":"CAROUSEL only: the list of card bodies (2–10 cards).","items":{"$ref":"#/components/schemas/templates.RcsTemplateCardBody"},"type":"array","uniqueItems":false},"messageOrder":{"description":"TEXT_WITH_PDF only: order of text and PDF in the message.","enum":["TEXT_MESSAGE_AT_TOP","TEXT_MESSAGE_AT_BOTTOM"],"type":"string"},"orientation":{"description":"CARD only: card orientation.","enum":["HORIZONTAL","VERTICAL"],"type":"string"},"suggestions":{"items":{"$ref":"#/components/schemas/templates.RcsTemplateSuggestion"},"type":"array","uniqueItems":false},"text":{"description":"TEXT and TEXT_WITH_PDF: the message body text. Supports {{parameter}} placeholders.","type":"string"},"type":{"enum":["TEXT","CARD","CAROUSEL","TEXT_WITH_PDF"],"type":"string"},"url":{"description":"TEXT_WITH_PDF only: publicly accessible URL of the PDF file.","type":"string"}},"type":"object"},"templates.RcsTemplateCardBody":{"properties":{"description":{"type":"string"},"media":{"$ref":"#/components/schemas/templates.RcsTemplateMedia"},"suggestions":{"items":{"$ref":"#/components/schemas/templates.RcsTemplateSuggestion"},"type":"array","uniqueItems":false},"title":{"type":"string"}},"type":"object"},"templates.RcsTemplateMedia":{"properties":{"file":{"$ref":"#/components/schemas/templates.RcsTemplateFile"},"height":{"enum":["SHORT","MEDIUM","TALL"],"type":"string"}},"type":"object"},"templates.RcsTemplateFile":{"properties":{"url":{"type":"string"}},"type":"object"},"templates.RcsTemplateSuggestion":{"properties":{"application":{"enum":["BROWSER","WEBVIEW"],"type":"string"},"label":{"type":"string"},"latitude":{"description":"SHOW_LOCATION","type":"number"},"longitude":{"type":"number"},"phoneNumber":{"description":"DIAL_PHONE","type":"string"},"postbackData":{"type":"string"},"text":{"type":"string"},"type":{"enum":["REPLY","OPEN_URL","DIAL_PHONE","SHOW_LOCATION","REQUEST_LOCATION","CREATE_CALENDAR_EVENT"],"type":"string"},"url":{"description":"OPEN_URL","type":"string"},"webviewViewMode":{"enum":["HALF","FULL","TALL"],"type":"string"}},"type":"object"},"templates.RcsTemplate":{"properties":{"content":{"$ref":"#/components/schemas/templates.RcsTemplateContent"},"lastUpdate":{"type":"string"},"name":{"type":"string"},"status":{"enum":["PENDING","APPROVED","REJECTED","SUSPENDED","APPROVED_IN_PROGRESS","APPROVED_PARTIALLY"],"type":"string"},"type":{"enum":["TEXT","CARD","CAROUSEL","TEXT_WITH_PDF"],"type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/senders/{sender}/templates/{templateName}":{"put":{"description":"Update an existing RCS template.","operationId":"put-rcs-sender-template","parameters":[{"description":"RCS sender (must match configured sender)","in":"path","name":"sender","required":true,"schema":{"type":"string"}},{"description":"Template name","in":"path","name":"templateName","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/templates.RcsUpdateTemplateRequest","summary":"requestBody","description":"Updated template content"}}},"description":"Updated template content","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/templates.RcsTemplate"}}},"description":"Template updated"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Sender mismatch or bad request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"}},"summary":"Update RCS Template","tags":["RCS"]}}}}
```

## Delete RCS Template

> Delete a specific RCS template.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.51.5"},"tags":[{"name":"RCS","description":"Endpoints for RCS integration"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/senders/{sender}/templates/{templateName}":{"delete":{"description":"Delete a specific RCS template.","operationId":"delete-rcs-sender-template","parameters":[{"description":"RCS sender (must match configured sender)","in":"path","name":"sender","required":true,"schema":{"type":"string"}},{"description":"Template name","in":"path","name":"templateName","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Template deleted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Sender mismatch"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"}},"summary":"Delete RCS Template","tags":["RCS"]}}}}
```

## Register RCS Template

> Register a specific RCS template for use.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.51.5"},"tags":[{"name":"RCS","description":"Endpoints for RCS integration"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"templates.RcsRegisterTemplateRequest":{"properties":{"providers":{"description":"Providers lists the providers to register with. Only providers not yet registered should be included.","items":{"type":"string"},"type":"array","uniqueItems":false}},"type":"object"},"templates.RcsTemplate":{"properties":{"content":{"$ref":"#/components/schemas/templates.RcsTemplateContent"},"lastUpdate":{"type":"string"},"name":{"type":"string"},"status":{"enum":["PENDING","APPROVED","REJECTED","SUSPENDED","APPROVED_IN_PROGRESS","APPROVED_PARTIALLY"],"type":"string"},"type":{"enum":["TEXT","CARD","CAROUSEL","TEXT_WITH_PDF"],"type":"string"}},"type":"object"},"templates.RcsTemplateContent":{"properties":{"alignment":{"description":"CARD only: media alignment within the card.","enum":["LEFT","RIGHT"],"type":"string"},"cardWidth":{"description":"CAROUSEL only: width of each card.","enum":["SMALL","MEDIUM"],"type":"string"},"content":{"$ref":"#/components/schemas/templates.RcsTemplateCardBody","description":"CARD only: the single card body."},"contents":{"description":"CAROUSEL only: the list of card bodies (2–10 cards).","items":{"$ref":"#/components/schemas/templates.RcsTemplateCardBody"},"type":"array","uniqueItems":false},"messageOrder":{"description":"TEXT_WITH_PDF only: order of text and PDF in the message.","enum":["TEXT_MESSAGE_AT_TOP","TEXT_MESSAGE_AT_BOTTOM"],"type":"string"},"orientation":{"description":"CARD only: card orientation.","enum":["HORIZONTAL","VERTICAL"],"type":"string"},"suggestions":{"items":{"$ref":"#/components/schemas/templates.RcsTemplateSuggestion"},"type":"array","uniqueItems":false},"text":{"description":"TEXT and TEXT_WITH_PDF: the message body text. Supports {{parameter}} placeholders.","type":"string"},"type":{"enum":["TEXT","CARD","CAROUSEL","TEXT_WITH_PDF"],"type":"string"},"url":{"description":"TEXT_WITH_PDF only: publicly accessible URL of the PDF file.","type":"string"}},"type":"object"},"templates.RcsTemplateCardBody":{"properties":{"description":{"type":"string"},"media":{"$ref":"#/components/schemas/templates.RcsTemplateMedia"},"suggestions":{"items":{"$ref":"#/components/schemas/templates.RcsTemplateSuggestion"},"type":"array","uniqueItems":false},"title":{"type":"string"}},"type":"object"},"templates.RcsTemplateMedia":{"properties":{"file":{"$ref":"#/components/schemas/templates.RcsTemplateFile"},"height":{"enum":["SHORT","MEDIUM","TALL"],"type":"string"}},"type":"object"},"templates.RcsTemplateFile":{"properties":{"url":{"type":"string"}},"type":"object"},"templates.RcsTemplateSuggestion":{"properties":{"application":{"enum":["BROWSER","WEBVIEW"],"type":"string"},"label":{"type":"string"},"latitude":{"description":"SHOW_LOCATION","type":"number"},"longitude":{"type":"number"},"phoneNumber":{"description":"DIAL_PHONE","type":"string"},"postbackData":{"type":"string"},"text":{"type":"string"},"type":{"enum":["REPLY","OPEN_URL","DIAL_PHONE","SHOW_LOCATION","REQUEST_LOCATION","CREATE_CALENDAR_EVENT"],"type":"string"},"url":{"description":"OPEN_URL","type":"string"},"webviewViewMode":{"enum":["HALF","FULL","TALL"],"type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/senders/{sender}/templates/{templateName}/register":{"patch":{"description":"Register a specific RCS template for use.","operationId":"patch-rcs-sender-template-register","parameters":[{"description":"RCS sender (must match configured sender)","in":"path","name":"sender","required":true,"schema":{"type":"string"}},{"description":"Template name","in":"path","name":"templateName","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/templates.RcsRegisterTemplateRequest","summary":"requestBody","description":"Registration options"}}},"description":"Registration options"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/templates.RcsTemplate"}}},"description":"Template registered"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Sender mismatch"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"}},"summary":"Register RCS Template","tags":["RCS"]}}}}
```

## Get RCS Template Status

> Retrieve the approval status of a specific RCS template.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.51.5"},"tags":[{"name":"RCS","description":"Endpoints for RCS integration"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"templates.RcsTemplateStatusResponse":{"properties":{"coverage":{"items":{"$ref":"#/components/schemas/templates.RcsTemplateCountryCoverage"},"type":"array","uniqueItems":false},"name":{"type":"string"},"status":{"enum":["PENDING","APPROVED","REJECTED","SUSPENDED","APPROVED_IN_PROGRESS","APPROVED_PARTIALLY"],"type":"string"}},"type":"object"},"templates.RcsTemplateCountryCoverage":{"properties":{"countryCode":{"type":"string"},"providers":{"items":{"$ref":"#/components/schemas/templates.RcsTemplateProviderStatus"},"type":"array","uniqueItems":false}},"type":"object"},"templates.RcsTemplateProviderStatus":{"properties":{"providerName":{"type":"string"},"status":{"enum":["PENDING","APPROVED","REJECTED","SUSPENDED"],"type":"string"},"updatedAt":{"type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/senders/{sender}/templates/{templateName}/status":{"get":{"description":"Retrieve the approval status of a specific RCS template.","operationId":"get-rcs-sender-template-status","parameters":[{"description":"RCS sender (must match configured sender)","in":"path","name":"sender","required":true,"schema":{"type":"string"}},{"description":"Template name","in":"path","name":"templateName","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/templates.RcsTemplateStatusResponse"}}},"description":"Template status"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Sender mismatch"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized"}},"summary":"Get RCS Template Status","tags":["RCS"]}}}}
```

## List RCS Template Providers

> Retrieve the list of available RCS template providers for this number's RCS sender.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.51.5"},"tags":[{"name":"RCS","description":"Endpoints for RCS integration"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"templates.RcsTemplateProvidersResponse":{"properties":{"providers":{"items":{"type":"string"},"type":"array","uniqueItems":false}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/templates/template-providers":{"get":{"description":"Retrieve the list of available RCS template providers for this number's RCS sender.","operationId":"get-rcs-template-providers","parameters":[{"description":"Sender ID. Defaults to the number's configured RCS sender; any other sender is rejected with 401","in":"query","name":"sender","schema":{"type":"string"}},{"description":"Filter providers by country code (e.g. DE, US)","in":"query","name":"countryCode","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/templates.RcsTemplateProvidersResponse"}}},"description":"Providers retrieved"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Unauthorized or sender mismatch"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"RCS not configured for this number"}},"summary":"List RCS Template Providers","tags":["RCS"]}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.360dialog.com/docs/messaging-api/api-reference/rcs.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.