# 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.41.0"},"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":{"oneOf":[{"type":"object"},{"$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.41.0"},"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":{"oneOf":[{"type":"object"},{"$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 event via InfoBIP RCS.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.41.0"},"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 event via InfoBIP RCS.","operationId":"post-rcs-events","requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object"},{"$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 sent RCS messages.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.41.0"},"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"},"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.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 sent RCS messages.","operationId":"get-rcs-logs","parameters":[{"description":"Sender number","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":"Entity ID to filter by","in":"query","name":"entityId","schema":{"type":"string"}},{"description":"Application ID to filter by","in":"query","name":"applicationId","schema":{"type":"string"}},{"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"}},"summary":"Get RCS Message Logs","tags":["RCS"]}}}}
```

## Send RCS Message

> Send an RCS message via InfoBIP. The \`sender\` field is validated against the configured sender and injected if absent.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.41.0"},"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. Validated against the stack's configured sender;\ninjected automatically if omitted.","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"},"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"},"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":{"description":"CARD: the single card body (title, description, media, suggestions).","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":{"description":"FILE: the media file to send.","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"},"platform":{"$ref":"#/components/schemas/messaging.RcsPlatform"},"smsFailover":{"$ref":"#/components/schemas/messaging.RcsSmsFailover"},"validityPeriod":{"$ref":"#/components/schemas/messaging.RcsValidityPeriod"}},"type":"object"},"messaging.RcsPlatform":{"properties":{"applicationId":{"type":"string"},"entityId":{"type":"string"}},"type":"object"},"messaging.RcsSmsFailover":{"properties":{"sender":{"type":"string"},"text":{"type":"string"}},"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 via InfoBIP. The `sender` field is validated against the configured sender and injected if absent.","operationId":"post-rcs-messages","requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object"},{"$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 sender mismatch"},"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":"Send RCS Message","tags":["RCS"]}}}}
```

## Get RCS Delivery Reports

> Retrieve delivery reports for sent RCS messages.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.41.0"},"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"},"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.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 sent RCS 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":"Entity ID used to further filter the result","in":"query","name":"entityId","schema":{"type":"string"}},{"description":"Application ID used to further filter the result","in":"query","name":"applicationId","schema":{"type":"string"}},{"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"}},"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.41.0"},"tags":[{"name":"Templates","description":"Endpoints for managing WhatsApp message templates"},{"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"},"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":{"description":"CARD only: the single card body.","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","Templates"]}}}}
```

## Create RCS Template

> Create a new RCS template for the configured sender.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.41.0"},"tags":[{"name":"Templates","description":"Endpoints for managing WhatsApp message templates"},{"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"},"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":{"description":"CARD only: the single card body.","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":{"oneOf":[{"type":"object"},{"$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","Templates"]}}}}
```

## Get RCS Template

> Retrieve details of a specific RCS template.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.41.0"},"tags":[{"name":"Templates","description":"Endpoints for managing WhatsApp message templates"},{"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"},"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":{"description":"CARD only: the single card body.","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","Templates"]}}}}
```

## Update RCS Template

> Update an existing RCS template.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.41.0"},"tags":[{"name":"Templates","description":"Endpoints for managing WhatsApp message templates"},{"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"},"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":{"description":"CARD only: the single card body.","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":{"oneOf":[{"type":"object"},{"$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","Templates"]}}}}
```

## Delete RCS Template

> Delete a specific RCS template.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.41.0"},"tags":[{"name":"Templates","description":"Endpoints for managing WhatsApp message templates"},{"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","Templates"]}}}}
```

## Register RCS Template

> Register a specific RCS template for use.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.41.0"},"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"},"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":{"description":"CARD only: the single card body.","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":{"oneOf":[{"type":"object"},{"$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.41.0"},"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.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.41.0"},"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.","operationId":"get-rcs-template-providers","parameters":[{"description":"Filter providers by sender","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"}},"summary":"List RCS Template Providers","tags":["RCS"]}}}}
```


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

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

The question should be specific, self-contained, and written in natural language.
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.