> 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

Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.

**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.

**Typical flow**

1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).
2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).
3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).
4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.

**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.

**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.

**Errors.** Errors come in four shapes:

* `{"message": "..."}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).
* `{"error": "..."}`: invalid `D360-API-KEY` (401) or rate limit (429).
* `{"detail": "..."}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.
* `{"errorCode": "E400", "description": "...", "action": "...", "violations": [...], "resources": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.

**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.

## Check RCS Capability in Bulk

> Check up to 10,000 phone numbers in one request. The answer only confirms the checks were accepted; the result for each number is sent as it is known (see the RCS capability check result webhook): to \`notifyUrl\` when it is set, otherwise to the number's RCS webhook (\`PUT /rcs/v1/configs/webhook\`).\
> \
> The sender must belong to the number. Results posted to \`notifyUrl\` come straight from the RCS provider: they don't carry \`x-360dialog-signature\` or your webhook headers. Results sent to the number's RCS webhook carry both, like other RCS events.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"RCS","description":"Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.\n\n**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.\n\n**Typical flow**\n1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).\n2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).\n3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).\n4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.\n\n**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.\n\n**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.\n\n**Errors.** Errors come in four shapes:\n- `{\"message\": \"...\"}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).\n- `{\"error\": \"...\"}`: invalid `D360-API-KEY` (401) or rate limit (429).\n- `{\"detail\": \"...\"}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.\n- `{\"errorCode\": \"E400\", \"description\": \"...\", \"action\": \"...\", \"violations\": [...], \"resources\": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.\n\n**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.\n"}],"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 of the results. Default application/json","enum":["application/json","application/xml"],"type":"string"},"notifyUrl":{"description":"NotifyUrl receives one result per phone number (see the RCS capability check result webhook).\nOptional: without it, the results go to the number's RCS webhook (PUT /rcs/v1/configs/webhook)","type":"string"},"phoneNumbers":{"description":"PhoneNumbers to check, in international format: 1–10,000","items":{"type":"string"},"maxItems":10000,"minItems":1,"type":"array","uniqueItems":false},"sender":{"description":"Sender to check the numbers against. It must belong to the number","type":"string"}},"required":["phoneNumbers","sender"],"type":"object"},"capability.RcsCapabilityCheckAsyncResponse":{"properties":{"bulkId":{"description":"BulkId of the request; the results carry it","type":"string"},"capabilityCheckRequestStates":{"items":{"$ref":"#/components/schemas/capability.RcsCapabilityCheckRequestState"},"type":"array","uniqueItems":false}},"type":"object"},"capability.RcsCapabilityCheckRequestState":{"properties":{"messageId":{"description":"MessageId of the check; its result carries it","type":"string"},"phoneNumber":{"type":"string"},"status":{"description":"Status of the request, e.g. PENDING_ENROUTE, or a rejection such as INVALID_DESTINATION_ADDRESS","type":"string"}},"type":"object"},"rcsdocs.RcsError":{"properties":{"message":{"description":"Message says why the request was refused, e.g. \"sender is required\",\n\"Sender DemoSender does not belong to this account\", \"RCS not enabled for this stack\",\n\"invalid JSON body\", \"Invalid template name\" or \"RCS entity not configured\"","type":"string"}},"type":"object"},"rcsdocs.RcsProviderError":{"properties":{"action":{"description":"Action suggested to fix the request","type":"string"},"description":{"description":"Description of the error","type":"string"},"errorCode":{"description":"ErrorCode is the HTTP status as a code, e.g. E400, E404, E409, E429","type":"string"},"resources":{"description":"Resources links to documentation about the error; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorResource"},"type":"array","uniqueItems":false},"violations":{"description":"Violations lists the invalid fields of the request; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorViolation"},"type":"array","uniqueItems":false}},"required":["action","description","errorCode","resources","violations"],"type":"object"},"rcsdocs.RcsProviderErrorResource":{"properties":{"name":{"type":"string"},"url":{"type":"string"}},"type":"object"},"rcsdocs.RcsProviderErrorViolation":{"properties":{"property":{"description":"Property is the path of the invalid field","type":"string"},"violation":{"description":"Violation says what is wrong with it","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/capability-check/notify":{"post":{"description":"Check up to 10,000 phone numbers in one request. The answer only confirms the checks were accepted; the result for each number is sent as it is known (see the RCS capability check result webhook): to `notifyUrl` when it is set, otherwise to the number's RCS webhook (`PUT /rcs/v1/configs/webhook`).\n\nThe sender must belong to the number. Results posted to `notifyUrl` come straight from the RCS provider: they don't carry `x-360dialog-signature` or your webhook headers. Results sent to the number's RCS webhook carry both, like other RCS events.","operationId":"post-rcs-capability-check-notify","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/capability.RcsCapabilityCheckAsyncRequest","summary":"requestBody","description":"Numbers to check"}}},"description":"Numbers to check","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/capability.RcsCapabilityCheckAsyncResponse"}}},"description":"Checks accepted"},"400":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsError"},{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}]}}},"description":"No sender, or the body is not a JSON object (body `message`), or rejected by the RCS provider: invalid request, see violations (body `errorCode`)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Invalid D360-API-KEY"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"RCS not enabled for the number, or the sender does not belong to it"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Rate limit exceeded"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}}},"description":"RCS provider error"}},"summary":"Check RCS Capability in Bulk","tags":["RCS"]}}}}
```

## Check RCS Capability

> Check whether phone numbers can receive RCS messages from a sender, and get the answer right away. Use it just before sending, to choose between RCS and another channel.\
> \
> \- Up to 500 numbers per request; 1–10 is recommended. For more, use \`POST /rcs/v1/capability-check/notify\`.\
> \- The sender must belong to the number. A sender that is not launched on a recipient's network always gets a negative result for it.\
> \- Up to 100 requests per second.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"RCS","description":"Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.\n\n**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.\n\n**Typical flow**\n1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).\n2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).\n3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).\n4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.\n\n**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.\n\n**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.\n\n**Errors.** Errors come in four shapes:\n- `{\"message\": \"...\"}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).\n- `{\"error\": \"...\"}`: invalid `D360-API-KEY` (401) or rate limit (429).\n- `{\"detail\": \"...\"}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.\n- `{\"errorCode\": \"E400\", \"description\": \"...\", \"action\": \"...\", \"violations\": [...], \"resources\": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.\n\n**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.\n"}],"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 to check, in international format: 1–500, ideally 1–10","items":{"type":"string"},"maxItems":500,"minItems":1,"type":"array","uniqueItems":false},"sender":{"description":"Sender to check the numbers against. It must belong to the number","type":"string"}},"required":["phoneNumbers","sender"],"type":"object"},"capability.RcsCapabilityCheckSyncResponse":{"properties":{"capabilityCheckResults":{"description":"CapabilityCheckResults has one result per phone number","items":{"$ref":"#/components/schemas/capability.RcsCapabilityCheckResult"},"type":"array","uniqueItems":false}},"type":"object"},"capability.RcsCapabilityCheckResult":{"properties":{"code":{"description":"Code is the result for the phone number","enum":["ENABLED","UNREACHABLE","REJECTED_NETWORK","REJECTED_ROUTE_NOT_AVAILABLE","REQUEST_FAILED","PROCESSING_ERROR","INVALID_DESTINATION_ADDRESS","UNKNOWN_CODE"],"type":"string"},"messageId":{"type":"string"},"phoneNumber":{"type":"string"}},"type":"object"},"rcsdocs.RcsError":{"properties":{"message":{"description":"Message says why the request was refused, e.g. \"sender is required\",\n\"Sender DemoSender does not belong to this account\", \"RCS not enabled for this stack\",\n\"invalid JSON body\", \"Invalid template name\" or \"RCS entity not configured\"","type":"string"}},"type":"object"},"rcsdocs.RcsProviderError":{"properties":{"action":{"description":"Action suggested to fix the request","type":"string"},"description":{"description":"Description of the error","type":"string"},"errorCode":{"description":"ErrorCode is the HTTP status as a code, e.g. E400, E404, E409, E429","type":"string"},"resources":{"description":"Resources links to documentation about the error; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorResource"},"type":"array","uniqueItems":false},"violations":{"description":"Violations lists the invalid fields of the request; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorViolation"},"type":"array","uniqueItems":false}},"required":["action","description","errorCode","resources","violations"],"type":"object"},"rcsdocs.RcsProviderErrorResource":{"properties":{"name":{"type":"string"},"url":{"type":"string"}},"type":"object"},"rcsdocs.RcsProviderErrorViolation":{"properties":{"property":{"description":"Property is the path of the invalid field","type":"string"},"violation":{"description":"Violation says what is wrong with it","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/capability-check/query":{"post":{"description":"Check whether phone numbers can receive RCS messages from a sender, and get the answer right away. Use it just before sending, to choose between RCS and another channel.\n\n- Up to 500 numbers per request; 1–10 is recommended. For more, use `POST /rcs/v1/capability-check/notify`.\n- The sender must belong to the number. A sender that is not launched on a recipient's network always gets a negative result for it.\n- Up to 100 requests per second.","operationId":"post-rcs-capability-check-query","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/capability.RcsCapabilityCheckSyncRequest","summary":"requestBody","description":"Numbers to check"}}},"description":"Numbers to check","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/capability.RcsCapabilityCheckSyncResponse"}}},"description":"One result per number"},"400":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsError"},{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}]}}},"description":"No sender, or the body is not a JSON object (body `message`), or rejected by the RCS provider: invalid request, see violations (body `errorCode`)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Invalid D360-API-KEY"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"RCS not enabled for the number, or the sender does not belong to it"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Rate limit exceeded"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}}},"description":"RCS provider error"}},"summary":"Check RCS Capability","tags":["RCS"]}}}}
```

## Get RCS Webhook Configuration

> Retrieve the URL RCS events of the number are sent to, and the custom headers sent with them. Header values are masked. \`url\` and \`headers\` are null when no webhook is set.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"RCS","description":"Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.\n\n**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.\n\n**Typical flow**\n1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).\n2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).\n3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).\n4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.\n\n**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.\n\n**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.\n\n**Errors.** Errors come in four shapes:\n- `{\"message\": \"...\"}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).\n- `{\"error\": \"...\"}`: invalid `D360-API-KEY` (401) or rate limit (429).\n- `{\"detail\": \"...\"}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.\n- `{\"errorCode\": \"E400\", \"description\": \"...\", \"action\": \"...\", \"violations\": [...], \"resources\": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.\n\n**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.\n"}],"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":{"webhook_config.RcsWebhookConfig":{"properties":{"headers":{"additionalProperties":{"type":"string"},"description":"Headers are added to every request sent to URL, e.g. for your own authentication.\nOptional. Values are masked in answers.","type":"object"},"url":{"description":"URL receives inbound messages, delivery reports and seen reports for every RCS sender\nof the number. Must be an absolute http or https URL. Null in a GET answer when no URL is set","type":"string"}},"required":["url"],"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"},"rcsdocs.RcsPlatformError":{"properties":{"detail":{"description":"Detail says why the request failed, e.g. \"Sender name is already taken\",\n\"Sender limit reached for this account\", \"RCS is not enabled for this stack\" or\nan invalid webhook URL. For a body that fails validation (HTTP 422) it is a list of\nthe invalid fields instead of a string.","type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/configs/webhook":{"get":{"description":"Retrieve the URL RCS events of the number are sent to, and the custom headers sent with them. Header values are masked. `url` and `headers` are null when no webhook is set.","operationId":"get-rcs-webhook-config","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/webhook_config.RcsWebhookConfig"}}},"description":"Webhook configuration retrieved"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Invalid D360-API-KEY"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsPlatformError"}}},"description":"Account not found"}},"summary":"Get RCS Webhook Configuration","tags":["RCS"]}}}}
```

## Set RCS Webhook Configuration

> Set the URL that receives the RCS events of the number: inbound messages, delivery reports and seen reports for every RCS sender of the number (see the RCS webhooks).\
> \
> \- The change applies immediately: the next event goes to the new URL.\
> \- \`headers\` are added to every event request, e.g. for your own authentication. Header values are masked in the answer.\
> \- Every event request also carries \`x-360dialog-signature\`: the hex HMAC-SHA256 of the raw request body, keyed with the number's signing secret. It is sent only when a signing secret is configured for the number, the same way as for WhatsApp webhooks.\
> \- The webhook can be set before RCS is enabled for the number; events arrive once it is.\
> \- Your endpoint should answer with a 2xx status quickly; do the processing asynchronously.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"RCS","description":"Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.\n\n**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.\n\n**Typical flow**\n1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).\n2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).\n3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).\n4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.\n\n**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.\n\n**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.\n\n**Errors.** Errors come in four shapes:\n- `{\"message\": \"...\"}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).\n- `{\"error\": \"...\"}`: invalid `D360-API-KEY` (401) or rate limit (429).\n- `{\"detail\": \"...\"}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.\n- `{\"errorCode\": \"E400\", \"description\": \"...\", \"action\": \"...\", \"violations\": [...], \"resources\": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.\n\n**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.\n"}],"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":{"webhook_config.RcsWebhookConfig":{"properties":{"headers":{"additionalProperties":{"type":"string"},"description":"Headers are added to every request sent to URL, e.g. for your own authentication.\nOptional. Values are masked in answers.","type":"object"},"url":{"description":"URL receives inbound messages, delivery reports and seen reports for every RCS sender\nof the number. Must be an absolute http or https URL. Null in a GET answer when no URL is set","type":"string"}},"required":["url"],"type":"object"},"rcsdocs.RcsPlatformError":{"properties":{"detail":{"description":"Detail says why the request failed, e.g. \"Sender name is already taken\",\n\"Sender limit reached for this account\", \"RCS is not enabled for this stack\" or\nan invalid webhook URL. For a body that fails validation (HTTP 422) it is a list of\nthe invalid fields instead of a string.","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/configs/webhook":{"put":{"description":"Set the URL that receives the RCS events of the number: inbound messages, delivery reports and seen reports for every RCS sender of the number (see the RCS webhooks).\n\n- The change applies immediately: the next event goes to the new URL.\n- `headers` are added to every event request, e.g. for your own authentication. Header values are masked in the answer.\n- Every event request also carries `x-360dialog-signature`: the hex HMAC-SHA256 of the raw request body, keyed with the number's signing secret. It is sent only when a signing secret is configured for the number, the same way as for WhatsApp webhooks.\n- The webhook can be set before RCS is enabled for the number; events arrive once it is.\n- Your endpoint should answer with a 2xx status quickly; do the processing asynchronously.","operationId":"set-rcs-webhook-config","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/webhook_config.RcsWebhookConfig","summary":"requestBody","description":"Webhook configuration"}}},"description":"Webhook configuration","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/webhook_config.RcsWebhookConfig"}}},"description":"Webhook configuration updated"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsPlatformError"}}},"description":"URL is not a valid http(s) URL"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Invalid D360-API-KEY"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsPlatformError"}}},"description":"Account not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsPlatformError"}}},"description":"Body is not valid, e.g. `url` is missing"}},"summary":"Set RCS Webhook Configuration","tags":["RCS"]}}}}
```

## Send RCS Event

> Send events to recipients: \`SEEN\` marks an inbound message as read (set \`content.messageId\` to the inbound message's ID), \`TYPING\_INDICATOR\` shows that you are typing.\
> \
> The \`sender\` of every event must belong to the number. Up to 100 requests per second; the body can be up to 10 MB.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"RCS","description":"Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.\n\n**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.\n\n**Typical flow**\n1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).\n2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).\n3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).\n4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.\n\n**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.\n\n**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.\n\n**Errors.** Errors come in four shapes:\n- `{\"message\": \"...\"}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).\n- `{\"error\": \"...\"}`: invalid `D360-API-KEY` (401) or rate limit (429).\n- `{\"detail\": \"...\"}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.\n- `{\"errorCode\": \"E400\", \"description\": \"...\", \"action\": \"...\", \"violations\": [...], \"resources\": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.\n\n**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.\n"}],"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"},"minItems":1,"type":"array","uniqueItems":false}},"required":["events"],"type":"object"},"messaging.RcsEvent":{"properties":{"content":{"$ref":"#/components/schemas/messaging.RcsEventContent"},"destinations":{"items":{"$ref":"#/components/schemas/messaging.RcsMessageDestination"},"minItems":1,"type":"array","uniqueItems":false},"options":{"$ref":"#/components/schemas/messaging.RcsEventOptions"},"sender":{"description":"Sender the event is sent from. It must belong to the number","type":"string"}},"required":["content","destinations","sender"],"type":"object"},"messaging.RcsEventContent":{"properties":{"messageId":{"description":"MessageId of the inbound message to mark as seen. Required for SEEN","type":"string"},"type":{"enum":["SEEN","TYPING_INDICATOR"],"type":"string"}},"required":["type"],"type":"object"},"messaging.RcsMessageDestination":{"properties":{"messageId":{"description":"MessageId is your own ID for the message to this recipient, 0–200 characters. Generated when not set","maxLength":200,"type":"string"},"to":{"description":"To is the recipient's phone number in international format","minLength":1,"type":"string"}},"required":["to"],"type":"object"},"messaging.RcsEventOptions":{"properties":{"deliveryTimeWindow":{"$ref":"#/components/schemas/rcsdocs.RcsDeliveryTimeWindow"}},"type":"object"},"rcsdocs.RcsDeliveryTimeWindow":{"properties":{"days":{"description":"Days the message can be delivered on","items":{"enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"],"type":"string"},"minItems":1,"type":"array","uniqueItems":false},"from":{"$ref":"#/components/schemas/rcsdocs.RcsTimeOfDay","description":"From is the start of the daily window. Set both from and to, or neither; at least 1 hour apart"},"to":{"$ref":"#/components/schemas/rcsdocs.RcsTimeOfDay","description":"To is the end of the daily window"}},"required":["days"],"type":"object"},"rcsdocs.RcsTimeOfDay":{"properties":{"hour":{"maximum":23,"minimum":0,"type":"integer"},"minute":{"maximum":59,"minimum":0,"type":"integer"}},"required":["hour","minute"],"type":"object"},"messaging.RcsSendMessageResponse":{"properties":{"bulkId":{"description":"BulkId of the request; it can filter reports and logs","type":"string"},"messages":{"description":"Messages has one entry per message and destination","items":{"$ref":"#/components/schemas/messaging.RcsMessageSendResult"},"type":"array","uniqueItems":false}},"type":"object"},"messaging.RcsMessageSendResult":{"properties":{"destination":{"description":"Destination is the recipient","type":"string"},"messageId":{"description":"MessageId identifies the message in reports, logs and webhooks","type":"string"},"status":{"$ref":"#/components/schemas/rcsdocs.RcsMessageStatus"}},"type":"object"},"rcsdocs.RcsMessageStatus":{"properties":{"action":{"description":"Action to take, if any","type":"string"},"description":{"type":"string"},"groupId":{"description":"GroupId of the status group","type":"integer"},"groupName":{"description":"GroupName of the status group","enum":["ACCEPTED","PENDING","UNDELIVERABLE","DELIVERED","EXPIRED","REJECTED"],"type":"string"},"id":{"description":"Id of the status","type":"integer"},"name":{"description":"Name of the status","type":"string"}},"type":"object"},"rcsdocs.RcsError":{"properties":{"message":{"description":"Message says why the request was refused, e.g. \"sender is required\",\n\"Sender DemoSender does not belong to this account\", \"RCS not enabled for this stack\",\n\"invalid JSON body\", \"Invalid template name\" or \"RCS entity not configured\"","type":"string"}},"type":"object"},"rcsdocs.RcsProviderError":{"properties":{"action":{"description":"Action suggested to fix the request","type":"string"},"description":{"description":"Description of the error","type":"string"},"errorCode":{"description":"ErrorCode is the HTTP status as a code, e.g. E400, E404, E409, E429","type":"string"},"resources":{"description":"Resources links to documentation about the error; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorResource"},"type":"array","uniqueItems":false},"violations":{"description":"Violations lists the invalid fields of the request; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorViolation"},"type":"array","uniqueItems":false}},"required":["action","description","errorCode","resources","violations"],"type":"object"},"rcsdocs.RcsProviderErrorResource":{"properties":{"name":{"type":"string"},"url":{"type":"string"}},"type":"object"},"rcsdocs.RcsProviderErrorViolation":{"properties":{"property":{"description":"Property is the path of the invalid field","type":"string"},"violation":{"description":"Violation says what is wrong with it","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/events":{"post":{"description":"Send events to recipients: `SEEN` marks an inbound message as read (set `content.messageId` to the inbound message's ID), `TYPING_INDICATOR` shows that you are typing.\n\nThe `sender` of every event must belong to the number. Up to 100 requests per second; the body can be up to 10 MB.","operationId":"post-rcs-events","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/messaging.RcsEventRequest","summary":"requestBody","description":"Events to send"}}},"description":"Events to send","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/messaging.RcsSendMessageResponse"}}},"description":"Events accepted"},"400":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsError"},{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}]}}},"description":"No sender, or the body is not a JSON object (body `message`), or rejected by the RCS provider: invalid event, see violations (body `errorCode`)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Invalid D360-API-KEY"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"RCS not enabled for the number, or a sender does not belong to it"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Rate limit exceeded"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}}},"description":"RCS provider error"}},"summary":"Send RCS Event","tags":["RCS"]}}}}
```

## Get RCS Message Logs

> Get logs of messages sent by the number, with their content, status and price.\
> \
> \- Logs are kept for 48 hours.\
> \- Up to 1000 logs per call. To page through more, set \`useCursor=true\` and pass \`cursor.nextCursor\` of each answer as \`cursor\` in the next call.\
> \- Results only ever contain the number's own messages, whatever filters are sent.\
> \- Up to 120 requests per minute.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"RCS","description":"Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.\n\n**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.\n\n**Typical flow**\n1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).\n2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).\n3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).\n4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.\n\n**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.\n\n**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.\n\n**Errors.** Errors come in four shapes:\n- `{\"message\": \"...\"}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).\n- `{\"error\": \"...\"}`: invalid `D360-API-KEY` (401) or rate limit (429).\n- `{\"detail\": \"...\"}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.\n- `{\"errorCode\": \"E400\", \"description\": \"...\", \"action\": \"...\", \"violations\": [...], \"resources\": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.\n\n**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.\n"}],"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","description":"Cursor is set when useCursor=true; pass nextCursor to get the next page"},"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 to get the next page. Not set on the last page","type":"string"}},"type":"object"},"reports.RcsMessageLog":{"properties":{"bulkId":{"type":"string"},"campaignReferenceId":{"type":"string"},"content":{"description":"Content of the message as sent","oneOf":[{"$ref":"#/components/schemas/messaging.RcsTextContent"},{"$ref":"#/components/schemas/messaging.RcsFileContent"},{"$ref":"#/components/schemas/messaging.RcsCardContent"},{"$ref":"#/components/schemas/messaging.RcsCarouselContent"},{"$ref":"#/components/schemas/messaging.RcsProviderTemplateContent"}]},"destination":{"description":"Destination is the recipient","type":"string"},"doneAt":{"description":"DoneAt is when the final status was reached","type":"string"},"error":{"$ref":"#/components/schemas/rcsdocs.RcsMessageError"},"messageCount":{"description":"MessageCount is the number of messages the content was split into","type":"integer"},"messageId":{"type":"string"},"platform":{"$ref":"#/components/schemas/rcsdocs.RcsPlatform"},"price":{"$ref":"#/components/schemas/rcsdocs.RcsPrice"},"sender":{"description":"Sender the message was sent from","type":"string"},"sentAt":{"description":"SentAt is when the message was sent, yyyy-MM-dd'T'HH:mm:ss.SSSZ","type":"string"},"status":{"$ref":"#/components/schemas/rcsdocs.RcsMessageStatus"}},"type":"object"},"messaging.RcsTextContent":{"properties":{"suggestions":{"description":"Suggestions shown as chips below the message. Up to 11","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":11,"type":"array","uniqueItems":false},"text":{"description":"Text of the message, up to 3072 characters","maxLength":3072,"type":"string"},"type":{"enum":["TEXT"],"type":"string"}},"required":["text","type"],"type":"object"},"rcsdocs.RcsReplySuggestion":{"properties":{"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["REPLY"],"type":"string"}},"required":["postbackData","text","type"],"type":"object"},"rcsdocs.RcsOpenUrlSuggestion":{"properties":{"application":{"description":"Application that opens the URL. The browser is used when not set or when the device has no webview support","enum":["BROWSER","WEBVIEW"],"type":"string"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["OPEN_URL"],"type":"string"},"url":{"description":"URL to open. http or https only, 1–2048 characters","maxLength":2048,"minLength":1,"type":"string"},"webviewViewMode":{"description":"WebviewViewMode is the webview size: FULL screen, HALF or TALL (three quarters). Required when application is WEBVIEW","enum":["FULL","HALF","TALL"],"type":"string"}},"required":["postbackData","text","type","url"],"type":"object"},"rcsdocs.RcsDialPhoneSuggestion":{"properties":{"phoneNumber":{"description":"PhoneNumber to dial, digits with an optional leading +, no spaces","pattern":"^\\+?[0-9]\\d{1,14}$","type":"string"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["DIAL_PHONE"],"type":"string"}},"required":["phoneNumber","postbackData","text","type"],"type":"object"},"rcsdocs.RcsShowLocationSuggestion":{"properties":{"label":{"description":"Label of the location. 1–100 characters","maxLength":100,"minLength":1,"type":"string"},"latitude":{"description":"Latitude, -90 to 90","maximum":90,"minimum":-90,"type":"number"},"longitude":{"description":"Longitude, -180 to 180","maximum":180,"minimum":-180,"type":"number"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["SHOW_LOCATION"],"type":"string"}},"required":["latitude","longitude","postbackData","text","type"],"type":"object"},"rcsdocs.RcsRequestLocationSuggestion":{"properties":{"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["REQUEST_LOCATION"],"type":"string"}},"required":["postbackData","text","type"],"type":"object"},"rcsdocs.RcsCreateCalendarEventSuggestion":{"properties":{"description":{"description":"Description of the event. 1–500 characters","maxLength":500,"minLength":1,"type":"string"},"endTime":{"description":"EndTime of the event, yyyy-MM-dd'T'HH:mm:ss.SSSZ. Must be after startTime","type":"string"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"startTime":{"description":"StartTime of the event, yyyy-MM-dd'T'HH:mm:ss.SSSZ. Must be in the future and before endTime","type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"title":{"description":"Title of the event. 1–100 characters","maxLength":100,"minLength":1,"type":"string"},"type":{"enum":["CREATE_CALENDAR_EVENT"],"type":"string"}},"required":["endTime","postbackData","startTime","text","title","type"],"type":"object"},"messaging.RcsFileContent":{"properties":{"file":{"$ref":"#/components/schemas/rcsdocs.RcsFile"},"suggestions":{"description":"Suggestions shown as chips below the message. Up to 11","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":11,"type":"array","uniqueItems":false},"thumbnail":{"$ref":"#/components/schemas/rcsdocs.RcsFile","description":"Thumbnail shown while a video loads. Video files only"},"type":{"enum":["FILE"],"type":"string"}},"required":["file","type"],"type":"object"},"rcsdocs.RcsFile":{"properties":{"url":{"description":"URL of the file, 1–2048 characters","maxLength":2048,"minLength":1,"type":"string"}},"required":["url"],"type":"object"},"messaging.RcsCardContent":{"properties":{"alignment":{"description":"Alignment of the media in a HORIZONTAL card","enum":["LEFT","RIGHT"],"type":"string"},"content":{"$ref":"#/components/schemas/rcsdocs.RcsCardBody"},"orientation":{"description":"Orientation of the card","enum":["HORIZONTAL","VERTICAL"],"type":"string"},"suggestions":{"description":"Suggestions shown as chips below the card. Up to 11","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":11,"type":"array","uniqueItems":false},"type":{"enum":["CARD"],"type":"string"}},"required":["alignment","content","orientation","type"],"type":"object"},"rcsdocs.RcsCardBody":{"properties":{"description":{"description":"Description below the title. 1–2000 characters","maxLength":2000,"minLength":1,"type":"string"},"media":{"$ref":"#/components/schemas/rcsdocs.RcsCardMedia"},"suggestions":{"description":"Suggestions shown as buttons on the card. Up to 4","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":4,"type":"array","uniqueItems":false},"title":{"description":"Title, shown in bold. 1–200 characters","maxLength":200,"minLength":1,"type":"string"}},"type":"object"},"rcsdocs.RcsCardMedia":{"properties":{"file":{"$ref":"#/components/schemas/rcsdocs.RcsFile","description":"File is the image or video shown on the card: JPEG, JPG, GIF, PNG, H263, M4V, MP4, MPEG,\nMPEG4 or WEBM. Support for some formats depends on the mobile network operator"},"height":{"description":"Height of the media on the card","enum":["SHORT","MEDIUM","TALL"],"type":"string"},"thumbnail":{"$ref":"#/components/schemas/rcsdocs.RcsFile","description":"Thumbnail shown while a video loads. Video files only"}},"required":["file","height"],"type":"object"},"messaging.RcsCarouselContent":{"properties":{"cardWidth":{"description":"CardWidth of every card","enum":["SMALL","MEDIUM"],"type":"string"},"contents":{"description":"Contents are the cards, 2–10","items":{"$ref":"#/components/schemas/rcsdocs.RcsCardBody"},"maxItems":10,"minItems":2,"type":"array","uniqueItems":false},"suggestions":{"description":"Suggestions shown as chips below the carousel. Up to 11","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":11,"type":"array","uniqueItems":false},"type":{"enum":["CAROUSEL"],"type":"string"}},"required":["cardWidth","contents","type"],"type":"object"},"messaging.RcsProviderTemplateContent":{"properties":{"parameters":{"description":"Parameters fill the {{placeholders}} of the template. Names must match the placeholders, otherwise the message fails with error 7018","items":{"$ref":"#/components/schemas/messaging.RcsTemplateParameter"},"type":"array","uniqueItems":false},"templateId":{"description":"TemplateId is the template name as created. A wrong name fails the message with error 7018","minLength":1,"type":"string"},"type":{"enum":["PROVIDER_TEMPLATE"],"type":"string"}},"required":["templateId","type"],"type":"object"},"messaging.RcsTemplateParameter":{"properties":{"name":{"description":"Name of the placeholder, without braces","minLength":1,"type":"string"},"value":{"description":"Value to put in its place","type":"string"}},"required":["name","value"],"type":"object"},"rcsdocs.RcsMessageError":{"properties":{"description":{"description":"Description of the error","type":"string"},"groupId":{"type":"integer"},"groupName":{"enum":["OK","HANDSET_ERRORS","USER_ERRORS","OPERATOR_ERRORS"],"type":"string"},"id":{"type":"integer"},"name":{"type":"string"},"permanent":{"description":"Permanent is true when sending the message again won't succeed","type":"boolean"}},"type":"object"},"rcsdocs.RcsPlatform":{"properties":{"applicationId":{"description":"ApplicationId is the 360dialog RCS application","type":"string"},"entityId":{"description":"EntityId is the 360dialog app ID of the number","type":"string"}},"type":"object"},"rcsdocs.RcsPrice":{"properties":{"currency":{"description":"Currency, ISO 4217","type":"string"},"pricePerMessage":{"description":"PricePerMessage is the rate for one message, without markup","type":"number"}},"type":"object"},"rcsdocs.RcsMessageStatus":{"properties":{"action":{"description":"Action to take, if any","type":"string"},"description":{"type":"string"},"groupId":{"description":"GroupId of the status group","type":"integer"},"groupName":{"description":"GroupName of the status group","enum":["ACCEPTED","PENDING","UNDELIVERABLE","DELIVERED","EXPIRED","REJECTED"],"type":"string"},"id":{"description":"Id of the status","type":"integer"},"name":{"description":"Name of the status","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"},"rcsdocs.RcsError":{"properties":{"message":{"description":"Message says why the request was refused, e.g. \"sender is required\",\n\"Sender DemoSender does not belong to this account\", \"RCS not enabled for this stack\",\n\"invalid JSON body\", \"Invalid template name\" or \"RCS entity not configured\"","type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/logs":{"get":{"description":"Get logs of messages sent by the number, with their content, status and price.\n\n- Logs are kept for 48 hours.\n- Up to 1000 logs per call. To page through more, set `useCursor=true` and pass `cursor.nextCursor` of each answer as `cursor` in the next call.\n- Results only ever contain the number's own messages, whatever filters are sent.\n- Up to 120 requests per minute.","operationId":"get-rcs-logs","parameters":[{"description":"Sender the messages were sent from","in":"query","name":"sender","schema":{"type":"string"}},{"description":"Recipient","in":"query","name":"destination","schema":{"type":"string"}},{"description":"Bulk IDs, comma-separated","in":"query","name":"bulkId","schema":{"type":"string"}},{"description":"Message IDs, comma-separated","in":"query","name":"messageId","schema":{"type":"string"}},{"description":"Status group of the messages","in":"query","name":"generalStatus","schema":{"enum":["ACCEPTED","PENDING","UNDELIVERABLE","DELIVERED","EXPIRED","REJECTED"],"type":"string"}},{"description":"Messages sent at or after this time, yyyy-MM-dd'T'HH:mm:ss.SSSZ","in":"query","name":"sentSince","schema":{"type":"string"}},{"description":"Messages sent before this time, yyyy-MM-dd'T'HH:mm:ss.SSSZ","in":"query","name":"sentUntil","schema":{"type":"string"}},{"description":"Maximum number of logs, default 50, maximum 1000","in":"query","name":"limit","schema":{"maximum":1000,"minimum":1,"type":"integer"}},{"description":"Campaign reference IDs, comma-separated","in":"query","name":"campaignReferenceId","schema":{"type":"string"}},{"description":"Page through the logs with a cursor","in":"query","name":"useCursor","schema":{"type":"boolean"}},{"description":"cursor.nextCursor of the previous answer. Leave out on the first call","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":"Invalid D360-API-KEY"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"RCS not enabled for the number"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Rate limit exceeded"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"RCS not configured for the number"}},"summary":"Get RCS Message Logs","tags":["RCS"]}}}}
```

## Send RCS Message

> Send one or more RCS messages. Each message has a sender, one or more destinations and one content: \`TEXT\`, \`FILE\`, \`CARD\`, \`CAROUSEL\` or \`PROVIDER\_TEMPLATE\` (an approved template).\
> \
> The answer means the messages were accepted, not delivered. Follow each \`messageId\` through delivery reports (RCS webhooks, or \`GET /rcs/v1/reports\`).\
> \
> \*\*Rules\*\*\
> \- The \`sender\` of every message must belong to the number; otherwise the request is refused with 403 and nothing is sent.\
> \- A sender that is not launched yet can only message its approved test numbers. Other recipients fail with error 7005 in the delivery report.\
> \- Check recipients first with \`POST /rcs/v1/capability-check/query\` if you don't know they can receive RCS. Recipients that can't fail with error 7002.\
> \- The request body can be up to 10 MB.\
> \
> \*\*Limits:\*\* text up to 3072 characters; card title 200 and description 2000 characters; 2–10 carousel cards; 11 suggestions per message and 4 per card; suggestion text 25 characters; files up to 100 MB; validity period up to 48 hours; scheduling up to 180 days ahead.\
> \
> \*\*Changed by 360dialog:\*\* \`smsFailover\`, \`mmsFailover\` and \`regional\` are removed from every message and its options (failover is not supported). A per-message \`webhooks\` object is removed, so delivery and seen reports always go to the number's RCS webhook, and \`callbackData\` is not available. \`options.platform\` is set by 360dialog.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"RCS","description":"Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.\n\n**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.\n\n**Typical flow**\n1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).\n2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).\n3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).\n4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.\n\n**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.\n\n**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.\n\n**Errors.** Errors come in four shapes:\n- `{\"message\": \"...\"}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).\n- `{\"error\": \"...\"}`: invalid `D360-API-KEY` (401) or rate limit (429).\n- `{\"detail\": \"...\"}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.\n- `{\"errorCode\": \"E400\", \"description\": \"...\", \"action\": \"...\", \"violations\": [...], \"resources\": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.\n\n**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.\n"}],"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 to send. Each message goes to all of its destinations","items":{"$ref":"#/components/schemas/messaging.RcsMessage"},"minItems":1,"type":"array","uniqueItems":false},"options":{"$ref":"#/components/schemas/messaging.RcsRequestOptions"}},"required":["messages"],"type":"object"},"messaging.RcsMessage":{"properties":{"content":{"description":"Content of the message; type selects the content type","oneOf":[{"$ref":"#/components/schemas/messaging.RcsTextContent"},{"$ref":"#/components/schemas/messaging.RcsFileContent"},{"$ref":"#/components/schemas/messaging.RcsCardContent"},{"$ref":"#/components/schemas/messaging.RcsCarouselContent"},{"$ref":"#/components/schemas/messaging.RcsProviderTemplateContent"}]},"destinations":{"description":"Destinations are the recipients of the message; each one gets its own messageId","items":{"$ref":"#/components/schemas/messaging.RcsMessageDestination"},"minItems":1,"type":"array","uniqueItems":false},"options":{"$ref":"#/components/schemas/messaging.RcsMessageOptions"},"sender":{"description":"Sender is the RCS sender the message is sent from. It must belong to the number","type":"string"}},"required":["content","destinations","sender"],"type":"object"},"messaging.RcsTextContent":{"properties":{"suggestions":{"description":"Suggestions shown as chips below the message. Up to 11","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":11,"type":"array","uniqueItems":false},"text":{"description":"Text of the message, up to 3072 characters","maxLength":3072,"type":"string"},"type":{"enum":["TEXT"],"type":"string"}},"required":["text","type"],"type":"object"},"rcsdocs.RcsReplySuggestion":{"properties":{"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["REPLY"],"type":"string"}},"required":["postbackData","text","type"],"type":"object"},"rcsdocs.RcsOpenUrlSuggestion":{"properties":{"application":{"description":"Application that opens the URL. The browser is used when not set or when the device has no webview support","enum":["BROWSER","WEBVIEW"],"type":"string"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["OPEN_URL"],"type":"string"},"url":{"description":"URL to open. http or https only, 1–2048 characters","maxLength":2048,"minLength":1,"type":"string"},"webviewViewMode":{"description":"WebviewViewMode is the webview size: FULL screen, HALF or TALL (three quarters). Required when application is WEBVIEW","enum":["FULL","HALF","TALL"],"type":"string"}},"required":["postbackData","text","type","url"],"type":"object"},"rcsdocs.RcsDialPhoneSuggestion":{"properties":{"phoneNumber":{"description":"PhoneNumber to dial, digits with an optional leading +, no spaces","pattern":"^\\+?[0-9]\\d{1,14}$","type":"string"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["DIAL_PHONE"],"type":"string"}},"required":["phoneNumber","postbackData","text","type"],"type":"object"},"rcsdocs.RcsShowLocationSuggestion":{"properties":{"label":{"description":"Label of the location. 1–100 characters","maxLength":100,"minLength":1,"type":"string"},"latitude":{"description":"Latitude, -90 to 90","maximum":90,"minimum":-90,"type":"number"},"longitude":{"description":"Longitude, -180 to 180","maximum":180,"minimum":-180,"type":"number"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["SHOW_LOCATION"],"type":"string"}},"required":["latitude","longitude","postbackData","text","type"],"type":"object"},"rcsdocs.RcsRequestLocationSuggestion":{"properties":{"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["REQUEST_LOCATION"],"type":"string"}},"required":["postbackData","text","type"],"type":"object"},"rcsdocs.RcsCreateCalendarEventSuggestion":{"properties":{"description":{"description":"Description of the event. 1–500 characters","maxLength":500,"minLength":1,"type":"string"},"endTime":{"description":"EndTime of the event, yyyy-MM-dd'T'HH:mm:ss.SSSZ. Must be after startTime","type":"string"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"startTime":{"description":"StartTime of the event, yyyy-MM-dd'T'HH:mm:ss.SSSZ. Must be in the future and before endTime","type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"title":{"description":"Title of the event. 1–100 characters","maxLength":100,"minLength":1,"type":"string"},"type":{"enum":["CREATE_CALENDAR_EVENT"],"type":"string"}},"required":["endTime","postbackData","startTime","text","title","type"],"type":"object"},"messaging.RcsFileContent":{"properties":{"file":{"$ref":"#/components/schemas/rcsdocs.RcsFile"},"suggestions":{"description":"Suggestions shown as chips below the message. Up to 11","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":11,"type":"array","uniqueItems":false},"thumbnail":{"$ref":"#/components/schemas/rcsdocs.RcsFile","description":"Thumbnail shown while a video loads. Video files only"},"type":{"enum":["FILE"],"type":"string"}},"required":["file","type"],"type":"object"},"rcsdocs.RcsFile":{"properties":{"url":{"description":"URL of the file, 1–2048 characters","maxLength":2048,"minLength":1,"type":"string"}},"required":["url"],"type":"object"},"messaging.RcsCardContent":{"properties":{"alignment":{"description":"Alignment of the media in a HORIZONTAL card","enum":["LEFT","RIGHT"],"type":"string"},"content":{"$ref":"#/components/schemas/rcsdocs.RcsCardBody"},"orientation":{"description":"Orientation of the card","enum":["HORIZONTAL","VERTICAL"],"type":"string"},"suggestions":{"description":"Suggestions shown as chips below the card. Up to 11","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":11,"type":"array","uniqueItems":false},"type":{"enum":["CARD"],"type":"string"}},"required":["alignment","content","orientation","type"],"type":"object"},"rcsdocs.RcsCardBody":{"properties":{"description":{"description":"Description below the title. 1–2000 characters","maxLength":2000,"minLength":1,"type":"string"},"media":{"$ref":"#/components/schemas/rcsdocs.RcsCardMedia"},"suggestions":{"description":"Suggestions shown as buttons on the card. Up to 4","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":4,"type":"array","uniqueItems":false},"title":{"description":"Title, shown in bold. 1–200 characters","maxLength":200,"minLength":1,"type":"string"}},"type":"object"},"rcsdocs.RcsCardMedia":{"properties":{"file":{"$ref":"#/components/schemas/rcsdocs.RcsFile","description":"File is the image or video shown on the card: JPEG, JPG, GIF, PNG, H263, M4V, MP4, MPEG,\nMPEG4 or WEBM. Support for some formats depends on the mobile network operator"},"height":{"description":"Height of the media on the card","enum":["SHORT","MEDIUM","TALL"],"type":"string"},"thumbnail":{"$ref":"#/components/schemas/rcsdocs.RcsFile","description":"Thumbnail shown while a video loads. Video files only"}},"required":["file","height"],"type":"object"},"messaging.RcsCarouselContent":{"properties":{"cardWidth":{"description":"CardWidth of every card","enum":["SMALL","MEDIUM"],"type":"string"},"contents":{"description":"Contents are the cards, 2–10","items":{"$ref":"#/components/schemas/rcsdocs.RcsCardBody"},"maxItems":10,"minItems":2,"type":"array","uniqueItems":false},"suggestions":{"description":"Suggestions shown as chips below the carousel. Up to 11","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":11,"type":"array","uniqueItems":false},"type":{"enum":["CAROUSEL"],"type":"string"}},"required":["cardWidth","contents","type"],"type":"object"},"messaging.RcsProviderTemplateContent":{"properties":{"parameters":{"description":"Parameters fill the {{placeholders}} of the template. Names must match the placeholders, otherwise the message fails with error 7018","items":{"$ref":"#/components/schemas/messaging.RcsTemplateParameter"},"type":"array","uniqueItems":false},"templateId":{"description":"TemplateId is the template name as created. A wrong name fails the message with error 7018","minLength":1,"type":"string"},"type":{"enum":["PROVIDER_TEMPLATE"],"type":"string"}},"required":["templateId","type"],"type":"object"},"messaging.RcsTemplateParameter":{"properties":{"name":{"description":"Name of the placeholder, without braces","minLength":1,"type":"string"},"value":{"description":"Value to put in its place","type":"string"}},"required":["name","value"],"type":"object"},"messaging.RcsMessageDestination":{"properties":{"messageId":{"description":"MessageId is your own ID for the message to this recipient, 0–200 characters. Generated when not set","maxLength":200,"type":"string"},"to":{"description":"To is the recipient's phone number in international format","minLength":1,"type":"string"}},"required":["to"],"type":"object"},"messaging.RcsMessageOptions":{"properties":{"campaignReferenceId":{"description":"CampaignReferenceId groups messages of a campaign; it can filter reports and logs. Up to 255 characters","maxLength":255,"type":"string"},"deliveryTimeWindow":{"$ref":"#/components/schemas/rcsdocs.RcsDeliveryTimeWindow"},"validityPeriod":{"$ref":"#/components/schemas/messaging.RcsValidityPeriod"}},"type":"object"},"rcsdocs.RcsDeliveryTimeWindow":{"properties":{"days":{"description":"Days the message can be delivered on","items":{"enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"],"type":"string"},"minItems":1,"type":"array","uniqueItems":false},"from":{"$ref":"#/components/schemas/rcsdocs.RcsTimeOfDay","description":"From is the start of the daily window. Set both from and to, or neither; at least 1 hour apart"},"to":{"$ref":"#/components/schemas/rcsdocs.RcsTimeOfDay","description":"To is the end of the daily window"}},"required":["days"],"type":"object"},"rcsdocs.RcsTimeOfDay":{"properties":{"hour":{"maximum":23,"minimum":0,"type":"integer"},"minute":{"maximum":59,"minimum":0,"type":"integer"}},"required":["hour","minute"],"type":"object"},"messaging.RcsValidityPeriod":{"properties":{"amount":{"description":"Amount of timeUnit, greater than 0","minimum":1,"type":"integer"},"timeUnit":{"description":"TimeUnit of amount. Default MINUTES","enum":["SECONDS","MINUTES","HOURS"],"type":"string"}},"required":["amount"],"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":{"description":"RespectOrder delivers the messages in the order of the request. Default true","type":"boolean"},"stopOnFailure":{"description":"StopOnFailure skips the rest when a message fails. Default true","type":"boolean"}},"type":"object"},"messaging.RcsSchedule":{"properties":{"bulkId":{"description":"BulkId is your ID for the request, up to 100 characters. Generated when not set","maxLength":100,"type":"string"},"sendAt":{"description":"SendAt schedules the messages, yyyy-MM-dd'T'HH:mm:ss.SSSZ, up to 180 days ahead","type":"string"},"sendingSpeedLimit":{"$ref":"#/components/schemas/messaging.RcsSendingSpeedLimit"}},"type":"object"},"messaging.RcsSendingSpeedLimit":{"properties":{"amount":{"description":"Amount of messages per timeUnit","minimum":1,"type":"integer"},"timeUnit":{"description":"TimeUnit of amount. Default MINUTE","enum":["MINUTE","HOUR","DAY"],"type":"string"}},"required":["amount"],"type":"object"},"messaging.RcsUrlTracking":{"properties":{"customDomain":{"description":"CustomDomain for shortened URLs; it must be set up for the account first","type":"string"},"removeProtocol":{"description":"RemoveProtocol removes http:// or https:// from shortened URLs. Default false","type":"boolean"},"shortenUrl":{"description":"ShortenUrl shortens URLs in the text. Default true","type":"boolean"},"trackClicks":{"description":"TrackClicks counts clicks on the shortened URLs. Default true","type":"boolean"},"trackingUrl":{"description":"TrackingUrl receives a click report for every click","type":"string"}},"type":"object"},"messaging.RcsSendMessageResponse":{"properties":{"bulkId":{"description":"BulkId of the request; it can filter reports and logs","type":"string"},"messages":{"description":"Messages has one entry per message and destination","items":{"$ref":"#/components/schemas/messaging.RcsMessageSendResult"},"type":"array","uniqueItems":false}},"type":"object"},"messaging.RcsMessageSendResult":{"properties":{"destination":{"description":"Destination is the recipient","type":"string"},"messageId":{"description":"MessageId identifies the message in reports, logs and webhooks","type":"string"},"status":{"$ref":"#/components/schemas/rcsdocs.RcsMessageStatus"}},"type":"object"},"rcsdocs.RcsMessageStatus":{"properties":{"action":{"description":"Action to take, if any","type":"string"},"description":{"type":"string"},"groupId":{"description":"GroupId of the status group","type":"integer"},"groupName":{"description":"GroupName of the status group","enum":["ACCEPTED","PENDING","UNDELIVERABLE","DELIVERED","EXPIRED","REJECTED"],"type":"string"},"id":{"description":"Id of the status","type":"integer"},"name":{"description":"Name of the status","type":"string"}},"type":"object"},"rcsdocs.RcsError":{"properties":{"message":{"description":"Message says why the request was refused, e.g. \"sender is required\",\n\"Sender DemoSender does not belong to this account\", \"RCS not enabled for this stack\",\n\"invalid JSON body\", \"Invalid template name\" or \"RCS entity not configured\"","type":"string"}},"type":"object"},"rcsdocs.RcsProviderError":{"properties":{"action":{"description":"Action suggested to fix the request","type":"string"},"description":{"description":"Description of the error","type":"string"},"errorCode":{"description":"ErrorCode is the HTTP status as a code, e.g. E400, E404, E409, E429","type":"string"},"resources":{"description":"Resources links to documentation about the error; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorResource"},"type":"array","uniqueItems":false},"violations":{"description":"Violations lists the invalid fields of the request; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorViolation"},"type":"array","uniqueItems":false}},"required":["action","description","errorCode","resources","violations"],"type":"object"},"rcsdocs.RcsProviderErrorResource":{"properties":{"name":{"type":"string"},"url":{"type":"string"}},"type":"object"},"rcsdocs.RcsProviderErrorViolation":{"properties":{"property":{"description":"Property is the path of the invalid field","type":"string"},"violation":{"description":"Violation says what is wrong with it","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/messages":{"post":{"description":"Send one or more RCS messages. Each message has a sender, one or more destinations and one content: `TEXT`, `FILE`, `CARD`, `CAROUSEL` or `PROVIDER_TEMPLATE` (an approved template).\n\nThe answer means the messages were accepted, not delivered. Follow each `messageId` through delivery reports (RCS webhooks, or `GET /rcs/v1/reports`).\n\n**Rules**\n- The `sender` of every message must belong to the number; otherwise the request is refused with 403 and nothing is sent.\n- A sender that is not launched yet can only message its approved test numbers. Other recipients fail with error 7005 in the delivery report.\n- Check recipients first with `POST /rcs/v1/capability-check/query` if you don't know they can receive RCS. Recipients that can't fail with error 7002.\n- The request body can be up to 10 MB.\n\n**Limits:** text up to 3072 characters; card title 200 and description 2000 characters; 2–10 carousel cards; 11 suggestions per message and 4 per card; suggestion text 25 characters; files up to 100 MB; validity period up to 48 hours; scheduling up to 180 days ahead.\n\n**Changed by 360dialog:** `smsFailover`, `mmsFailover` and `regional` are removed from every message and its options (failover is not supported). A per-message `webhooks` object is removed, so delivery and seen reports always go to the number's RCS webhook, and `callbackData` is not available. `options.platform` is set by 360dialog.","operationId":"post-rcs-messages","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/messaging.RcsMessageRequest","summary":"requestBody","description":"Messages to send"}}},"description":"Messages to send","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/messaging.RcsSendMessageResponse"}}},"description":"Messages accepted"},"400":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsError"},{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}]}}},"description":"No sender, or the body is not a JSON object (body `message`), or rejected by the RCS provider: invalid message, see violations (body `errorCode`)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Invalid D360-API-KEY"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"RCS not enabled for the number, or a sender does not belong to it"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Rate limit exceeded"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}}},"description":"RCS provider error"}},"summary":"Send RCS Message","tags":["RCS"]}}}}
```

## Get RCS Delivery Reports

> Get the latest delivery reports of messages sent by the number, as an alternative to delivery report webhooks.\
> \
> \- \*\*Each report is returned only once\*\*: a report you have fetched won't come back in later calls. Store what you need.\
> \- Reports are kept for 48 hours.\
> \- Results only ever contain the number's own messages, whatever filters are sent.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"RCS","description":"Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.\n\n**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.\n\n**Typical flow**\n1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).\n2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).\n3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).\n4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.\n\n**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.\n\n**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.\n\n**Errors.** Errors come in four shapes:\n- `{\"message\": \"...\"}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).\n- `{\"error\": \"...\"}`: invalid `D360-API-KEY` (401) or rate limit (429).\n- `{\"detail\": \"...\"}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.\n- `{\"errorCode\": \"E400\", \"description\": \"...\", \"action\": \"...\", \"violations\": [...], \"resources\": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.\n\n**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.\n"}],"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"},"campaignReferenceId":{"description":"CampaignReferenceId sent with the message","type":"string"},"doneAt":{"description":"DoneAt is when the final status was reached","type":"string"},"error":{"$ref":"#/components/schemas/rcsdocs.RcsMessageError"},"mccMnc":{"type":"string"},"messageCount":{"description":"MessageCount is the number of messages the content was split into","type":"integer"},"messageId":{"type":"string"},"platform":{"$ref":"#/components/schemas/rcsdocs.RcsPlatform"},"price":{"$ref":"#/components/schemas/rcsdocs.RcsPrice"},"sender":{"description":"Sender the message was sent from","type":"string"},"sentAt":{"description":"SentAt is when the message was sent, yyyy-MM-dd'T'HH:mm:ss.SSSZ","type":"string"},"status":{"$ref":"#/components/schemas/rcsdocs.RcsMessageStatus"},"to":{"description":"To is the recipient","type":"string"}},"type":"object"},"rcsdocs.RcsMessageError":{"properties":{"description":{"description":"Description of the error","type":"string"},"groupId":{"type":"integer"},"groupName":{"enum":["OK","HANDSET_ERRORS","USER_ERRORS","OPERATOR_ERRORS"],"type":"string"},"id":{"type":"integer"},"name":{"type":"string"},"permanent":{"description":"Permanent is true when sending the message again won't succeed","type":"boolean"}},"type":"object"},"rcsdocs.RcsPlatform":{"properties":{"applicationId":{"description":"ApplicationId is the 360dialog RCS application","type":"string"},"entityId":{"description":"EntityId is the 360dialog app ID of the number","type":"string"}},"type":"object"},"rcsdocs.RcsPrice":{"properties":{"currency":{"description":"Currency, ISO 4217","type":"string"},"pricePerMessage":{"description":"PricePerMessage is the rate for one message, without markup","type":"number"}},"type":"object"},"rcsdocs.RcsMessageStatus":{"properties":{"action":{"description":"Action to take, if any","type":"string"},"description":{"type":"string"},"groupId":{"description":"GroupId of the status group","type":"integer"},"groupName":{"description":"GroupName of the status group","enum":["ACCEPTED","PENDING","UNDELIVERABLE","DELIVERED","EXPIRED","REJECTED"],"type":"string"},"id":{"description":"Id of the status","type":"integer"},"name":{"description":"Name of the status","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"},"rcsdocs.RcsError":{"properties":{"message":{"description":"Message says why the request was refused, e.g. \"sender is required\",\n\"Sender DemoSender does not belong to this account\", \"RCS not enabled for this stack\",\n\"invalid JSON body\", \"Invalid template name\" or \"RCS entity not configured\"","type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/reports":{"get":{"description":"Get the latest delivery reports of messages sent by the number, as an alternative to delivery report webhooks.\n\n- **Each report is returned only once**: a report you have fetched won't come back in later calls. Store what you need.\n- Reports are kept for 48 hours.\n- Results only ever contain the number's own messages, whatever filters are sent.","operationId":"get-rcs-reports","parameters":[{"description":"Bulk ID of the send request","in":"query","name":"bulkId","schema":{"type":"string"}},{"description":"Message ID","in":"query","name":"messageId","schema":{"type":"string"}},{"description":"Maximum number of reports, default 50, maximum 1000","in":"query","name":"limit","schema":{"maximum":1000,"minimum":1,"type":"integer"}},{"description":"Campaign reference ID sent with the messages","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":"Invalid D360-API-KEY"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"RCS not enabled for the number"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Rate limit exceeded"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"RCS not configured for the number"}},"summary":"Get RCS Delivery Reports","tags":["RCS"]}}}}
```

## List RCS Senders

> List the RCS senders of the number.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"RCS","description":"Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.\n\n**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.\n\n**Typical flow**\n1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).\n2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).\n3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).\n4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.\n\n**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.\n\n**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.\n\n**Errors.** Errors come in four shapes:\n- `{\"message\": \"...\"}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).\n- `{\"error\": \"...\"}`: invalid `D360-API-KEY` (401) or rate limit (429).\n- `{\"detail\": \"...\"}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.\n- `{\"errorCode\": \"E400\", \"description\": \"...\", \"action\": \"...\", \"violations\": [...], \"resources\": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.\n\n**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.\n"}],"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":{"senders.RcsSendersResponse":{"properties":{"senders":{"items":{"$ref":"#/components/schemas/senders.RcsSenderItem"},"type":"array","uniqueItems":false}},"type":"object"},"senders.RcsSenderItem":{"properties":{"created_at":{"description":"CreatedAt is when the sender was added to the number","type":"string"},"sender_name":{"type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"},"rcsdocs.RcsPlatformError":{"properties":{"detail":{"description":"Detail says why the request failed, e.g. \"Sender name is already taken\",\n\"Sender limit reached for this account\", \"RCS is not enabled for this stack\" or\nan invalid webhook URL. For a body that fails validation (HTTP 422) it is a list of\nthe invalid fields instead of a string.","type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/senders":{"get":{"description":"List the RCS senders of the number.","operationId":"get-rcs-senders","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/senders.RcsSendersResponse"}}},"description":"Senders of the number"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Invalid D360-API-KEY"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsPlatformError"}}},"description":"RCS not enabled for the number"}},"summary":"List RCS Senders","tags":["RCS"]}}}}
```

## Create RCS Sender

> Create an RCS sender for the number: the brand profile recipients see. The sender is created asynchronously (status \`PENDING\`); follow it with \`GET /rcs/v1/senders/{sender}\`.\
> \
> \- Once it is \`READY\_FOR\_TESTING\`, it can message its approved test numbers (\`/rcs/v1/senders/{sender}/test-numbers\`). Messaging everyone needs a launch with the mobile network providers; follow it with \`GET /rcs/v1/senders/{sender}/launch-status\`.\
> \- \`senderName\` and \`hostingRegion\` can't be changed later.\
> \- The number of senders per number is limited by 360dialog. A sender name can belong to one number only; creating the same name again from the same number is safe.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"RCS","description":"Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.\n\n**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.\n\n**Typical flow**\n1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).\n2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).\n3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).\n4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.\n\n**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.\n\n**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.\n\n**Errors.** Errors come in four shapes:\n- `{\"message\": \"...\"}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).\n- `{\"error\": \"...\"}`: invalid `D360-API-KEY` (401) or rate limit (429).\n- `{\"detail\": \"...\"}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.\n- `{\"errorCode\": \"E400\", \"description\": \"...\", \"action\": \"...\", \"violations\": [...], \"resources\": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.\n\n**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.\n"}],"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":{"senders.RcsCreateSenderRequest":{"properties":{"bannerUrl":{"description":"BannerUrl of the banner image: JPG, JPEG or PNG, 1440×448 pixels, up to 200 KB","maxLength":2048,"type":"string"},"billingCategory":{"description":"BillingCategory: CONVERSATIONAL is billed per session, NON_CONVERSATIONAL per message","enum":["CONVERSATIONAL","NON_CONVERSATIONAL"],"type":"string"},"brand":{"$ref":"#/components/schemas/senders.RcsSenderBrand"},"color":{"description":"Color of the sender in hex, e.g. #0B78D0. Its contrast against white must be at least 4.5:1","pattern":"^#?([A-Fa-f0-9]{6})$","type":"string"},"description":{"description":"Description shown to recipients, 1–100 characters","maxLength":100,"minLength":1,"type":"string"},"displayName":{"description":"DisplayName shown to recipients, 1–40 characters","maxLength":40,"minLength":1,"type":"string"},"emails":{"description":"Emails: one contact email. At least one of phones, emails and websites is required","items":{"$ref":"#/components/schemas/senders.RcsSenderEmail"},"maxItems":1,"type":"array","uniqueItems":false},"hostingRegion":{"description":"HostingRegion of the sender. It can't be changed later","enum":["NORTH_AMERICA","EUROPE","ASIA_PACIFIC"],"type":"string"},"logoUrl":{"description":"LogoUrl of the logo: JPG, JPEG or PNG, 224×224 pixels, up to 50 KB","maxLength":2048,"type":"string"},"phones":{"description":"Phones: one contact phone. At least one of phones, emails and websites is required","items":{"$ref":"#/components/schemas/senders.RcsSenderPhone"},"maxItems":1,"type":"array","uniqueItems":false},"privacy":{"$ref":"#/components/schemas/senders.RcsSenderURL"},"senderName":{"description":"SenderName is the name used as sender when sending: 3–40 letters, digits, _ or -, with at least one letter. It can't be changed later","maxLength":40,"minLength":3,"pattern":"^(?=.*[a-zA-Z])[a-zA-Z0-9_-]+$","type":"string"},"termsOfService":{"$ref":"#/components/schemas/senders.RcsSenderURL"},"useCase":{"description":"UseCase of the messages the sender will send","enum":["OTP","TRANSACTIONAL","PROMOTIONAL","MULTI_USE"],"type":"string"},"websites":{"description":"Websites: one website. At least one of phones, emails and websites is required","items":{"$ref":"#/components/schemas/senders.RcsSenderWebsite"},"maxItems":1,"type":"array","uniqueItems":false}},"required":["bannerUrl","billingCategory","brand","color","description","displayName","hostingRegion","logoUrl","privacy","senderName","termsOfService","useCase"],"type":"object"},"senders.RcsSenderBrand":{"properties":{"brandName":{"description":"BrandName, 1–100 characters","maxLength":100,"minLength":1,"type":"string"}},"required":["brandName"],"type":"object"},"senders.RcsSenderEmail":{"properties":{"address":{"maxLength":100,"type":"string"},"label":{"description":"Label shown to recipients, 1–25 characters","maxLength":25,"minLength":1,"type":"string"}},"required":["address","label"],"type":"object"},"senders.RcsSenderPhone":{"properties":{"label":{"description":"Label shown to recipients, 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"phoneNumber":{"description":"PhoneNumber, international format with + or 3–20 digits","type":"string"}},"required":["label","phoneNumber"],"type":"object"},"senders.RcsSenderURL":{"properties":{"url":{"maxLength":2048,"type":"string"}},"required":["url"],"type":"object"},"senders.RcsSenderWebsite":{"properties":{"label":{"description":"Label shown to recipients, 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"url":{"maxLength":2048,"type":"string"}},"required":["label","url"],"type":"object"},"senders.RcsCreateSenderResponse":{"properties":{"senderName":{"type":"string"},"senderStatus":{"description":"SenderStatus is PENDING while the sender is created","type":"string"}},"type":"object"},"rcsdocs.RcsProviderError":{"properties":{"action":{"description":"Action suggested to fix the request","type":"string"},"description":{"description":"Description of the error","type":"string"},"errorCode":{"description":"ErrorCode is the HTTP status as a code, e.g. E400, E404, E409, E429","type":"string"},"resources":{"description":"Resources links to documentation about the error; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorResource"},"type":"array","uniqueItems":false},"violations":{"description":"Violations lists the invalid fields of the request; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorViolation"},"type":"array","uniqueItems":false}},"required":["action","description","errorCode","resources","violations"],"type":"object"},"rcsdocs.RcsProviderErrorResource":{"properties":{"name":{"type":"string"},"url":{"type":"string"}},"type":"object"},"rcsdocs.RcsProviderErrorViolation":{"properties":{"property":{"description":"Property is the path of the invalid field","type":"string"},"violation":{"description":"Violation says what is wrong with it","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"},"rcsdocs.RcsPlatformError":{"properties":{"detail":{"description":"Detail says why the request failed, e.g. \"Sender name is already taken\",\n\"Sender limit reached for this account\", \"RCS is not enabled for this stack\" or\nan invalid webhook URL. For a body that fails validation (HTTP 422) it is a list of\nthe invalid fields instead of a string.","type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/senders":{"post":{"description":"Create an RCS sender for the number: the brand profile recipients see. The sender is created asynchronously (status `PENDING`); follow it with `GET /rcs/v1/senders/{sender}`.\n\n- Once it is `READY_FOR_TESTING`, it can message its approved test numbers (`/rcs/v1/senders/{sender}/test-numbers`). Messaging everyone needs a launch with the mobile network providers; follow it with `GET /rcs/v1/senders/{sender}/launch-status`.\n- `senderName` and `hostingRegion` can't be changed later.\n- The number of senders per number is limited by 360dialog. A sender name can belong to one number only; creating the same name again from the same number is safe.","operationId":"post-rcs-senders","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/senders.RcsCreateSenderRequest","summary":"requestBody","description":"Sender profile"}}},"description":"Sender profile","required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/senders.RcsCreateSenderResponse"}}},"description":"Sender is being created"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}}},"description":"Invalid sender profile, see violations"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Invalid D360-API-KEY"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsPlatformError"}}},"description":"RCS not enabled for the number"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsPlatformError"}}},"description":"Sender name taken, no sender limit set, or sender limit reached"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsPlatformError"}}},"description":"senderName missing or longer than 255 characters"}},"summary":"Create RCS Sender","tags":["RCS"]}}}}
```

## Get RCS Sender

> Get a sender of the number with its profile and status.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"RCS","description":"Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.\n\n**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.\n\n**Typical flow**\n1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).\n2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).\n3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).\n4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.\n\n**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.\n\n**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.\n\n**Errors.** Errors come in four shapes:\n- `{\"message\": \"...\"}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).\n- `{\"error\": \"...\"}`: invalid `D360-API-KEY` (401) or rate limit (429).\n- `{\"detail\": \"...\"}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.\n- `{\"errorCode\": \"E400\", \"description\": \"...\", \"action\": \"...\", \"violations\": [...], \"resources\": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.\n\n**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.\n"}],"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":{"senders.RcsSender":{"properties":{"bannerUrl":{"description":"BannerUrl of the banner image: JPG, JPEG or PNG, 1440×448 pixels, up to 200 KB","maxLength":2048,"type":"string"},"billingCategory":{"description":"BillingCategory: CONVERSATIONAL is billed per session, NON_CONVERSATIONAL per message","enum":["CONVERSATIONAL","NON_CONVERSATIONAL"],"type":"string"},"brand":{"$ref":"#/components/schemas/senders.RcsSenderBrand"},"color":{"description":"Color of the sender in hex, e.g. #0B78D0. Its contrast against white must be at least 4.5:1","pattern":"^#?([A-Fa-f0-9]{6})$","type":"string"},"description":{"description":"Description shown to recipients, 1–100 characters","maxLength":100,"minLength":1,"type":"string"},"displayName":{"description":"DisplayName shown to recipients, 1–40 characters","maxLength":40,"minLength":1,"type":"string"},"emails":{"description":"Emails: one contact email. At least one of phones, emails and websites is required","items":{"$ref":"#/components/schemas/senders.RcsSenderEmail"},"maxItems":1,"type":"array","uniqueItems":false},"hostingRegion":{"description":"HostingRegion of the sender. It can't be changed later","enum":["NORTH_AMERICA","EUROPE","ASIA_PACIFIC"],"type":"string"},"logoUrl":{"description":"LogoUrl of the logo: JPG, JPEG or PNG, 224×224 pixels, up to 50 KB","maxLength":2048,"type":"string"},"phones":{"description":"Phones: one contact phone. At least one of phones, emails and websites is required","items":{"$ref":"#/components/schemas/senders.RcsSenderPhone"},"maxItems":1,"type":"array","uniqueItems":false},"privacy":{"$ref":"#/components/schemas/senders.RcsSenderURL"},"senderName":{"description":"SenderName is the name used as sender when sending: 3–40 letters, digits, _ or -, with at least one letter. It can't be changed later","maxLength":40,"minLength":3,"pattern":"^(?=.*[a-zA-Z])[a-zA-Z0-9_-]+$","type":"string"},"senderStatus":{"enum":["DRAFT","PENDING","READY_FOR_TESTING","PENDING_LAUNCH","SENDER_UPDATE_REQUIRED","LAUNCHED_IN_PROGRESS","LAUNCHED_PARTIAL_SUCCESS","LAUNCHED"],"type":"string"},"termsOfService":{"$ref":"#/components/schemas/senders.RcsSenderURL"},"updatedAt":{"description":"UpdatedAt is when the sender last changed","type":"string"},"useCase":{"description":"UseCase of the messages the sender will send","enum":["OTP","TRANSACTIONAL","PROMOTIONAL","MULTI_USE"],"type":"string"},"websites":{"description":"Websites: one website. At least one of phones, emails and websites is required","items":{"$ref":"#/components/schemas/senders.RcsSenderWebsite"},"maxItems":1,"type":"array","uniqueItems":false}},"required":["bannerUrl","billingCategory","brand","color","description","displayName","hostingRegion","logoUrl","privacy","senderName","termsOfService","useCase"],"type":"object"},"senders.RcsSenderBrand":{"properties":{"brandName":{"description":"BrandName, 1–100 characters","maxLength":100,"minLength":1,"type":"string"}},"required":["brandName"],"type":"object"},"senders.RcsSenderEmail":{"properties":{"address":{"maxLength":100,"type":"string"},"label":{"description":"Label shown to recipients, 1–25 characters","maxLength":25,"minLength":1,"type":"string"}},"required":["address","label"],"type":"object"},"senders.RcsSenderPhone":{"properties":{"label":{"description":"Label shown to recipients, 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"phoneNumber":{"description":"PhoneNumber, international format with + or 3–20 digits","type":"string"}},"required":["label","phoneNumber"],"type":"object"},"senders.RcsSenderURL":{"properties":{"url":{"maxLength":2048,"type":"string"}},"required":["url"],"type":"object"},"senders.RcsSenderWebsite":{"properties":{"label":{"description":"Label shown to recipients, 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"url":{"maxLength":2048,"type":"string"}},"required":["label","url"],"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"},"rcsdocs.RcsError":{"properties":{"message":{"description":"Message says why the request was refused, e.g. \"sender is required\",\n\"Sender DemoSender does not belong to this account\", \"RCS not enabled for this stack\",\n\"invalid JSON body\", \"Invalid template name\" or \"RCS entity not configured\"","type":"string"}},"type":"object"},"rcsdocs.RcsProviderError":{"properties":{"action":{"description":"Action suggested to fix the request","type":"string"},"description":{"description":"Description of the error","type":"string"},"errorCode":{"description":"ErrorCode is the HTTP status as a code, e.g. E400, E404, E409, E429","type":"string"},"resources":{"description":"Resources links to documentation about the error; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorResource"},"type":"array","uniqueItems":false},"violations":{"description":"Violations lists the invalid fields of the request; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorViolation"},"type":"array","uniqueItems":false}},"required":["action","description","errorCode","resources","violations"],"type":"object"},"rcsdocs.RcsProviderErrorResource":{"properties":{"name":{"type":"string"},"url":{"type":"string"}},"type":"object"},"rcsdocs.RcsProviderErrorViolation":{"properties":{"property":{"description":"Property is the path of the invalid field","type":"string"},"violation":{"description":"Violation says what is wrong with it","type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/senders/{sender}":{"get":{"description":"Get a sender of the number with its profile and status.","operationId":"get-rcs-sender","parameters":[{"description":"RCS sender (must belong to the number)","in":"path","name":"sender","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/senders.RcsSender"}}},"description":"Sender"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Invalid D360-API-KEY"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"RCS not enabled for the number, or the sender does not belong to it"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}}},"description":"Sender not found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Rate limit exceeded"}},"summary":"Get RCS Sender","tags":["RCS"]}}}}
```

## Get RCS Sender Launch Status

> Get the launch status of a sender per country and mobile network provider. A sender can message all recipients of a network once its provider is \`COMPLETED\`.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"RCS","description":"Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.\n\n**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.\n\n**Typical flow**\n1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).\n2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).\n3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).\n4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.\n\n**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.\n\n**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.\n\n**Errors.** Errors come in four shapes:\n- `{\"message\": \"...\"}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).\n- `{\"error\": \"...\"}`: invalid `D360-API-KEY` (401) or rate limit (429).\n- `{\"detail\": \"...\"}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.\n- `{\"errorCode\": \"E400\", \"description\": \"...\", \"action\": \"...\", \"violations\": [...], \"resources\": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.\n\n**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.\n"}],"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":{"senders.RcsSenderLaunchStatus":{"properties":{"coverage":{"items":{"$ref":"#/components/schemas/senders.RcsSenderLaunchCoverage"},"type":"array","uniqueItems":false},"senderName":{"type":"string"},"senderStatus":{"enum":["DRAFT","PENDING","READY_FOR_TESTING","PENDING_LAUNCH","SENDER_UPDATE_REQUIRED","LAUNCHED_IN_PROGRESS","LAUNCHED_PARTIAL_SUCCESS","LAUNCHED"],"type":"string"},"updatedAt":{"type":"string"}},"type":"object"},"senders.RcsSenderLaunchCoverage":{"properties":{"countryCode":{"description":"CountryCode, ISO 3166-1 alpha-2","type":"string"},"providers":{"items":{"$ref":"#/components/schemas/senders.RcsSenderLaunchProvider"},"type":"array","uniqueItems":false}},"type":"object"},"senders.RcsSenderLaunchProvider":{"properties":{"name":{"type":"string"},"rejectionReason":{"description":"RejectionReason says why the launch was rejected","type":"string"},"status":{"description":"Status: PENDING not submitted yet; IN_PROGRESS; COMPLETED launched; REJECTED; NOT_REQUESTED provider excluded; NEW provider newly available","enum":["PENDING","IN_PROGRESS","COMPLETED","REJECTED","NOT_REQUESTED","NEW"],"type":"string"},"updatedAt":{"type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"},"rcsdocs.RcsError":{"properties":{"message":{"description":"Message says why the request was refused, e.g. \"sender is required\",\n\"Sender DemoSender does not belong to this account\", \"RCS not enabled for this stack\",\n\"invalid JSON body\", \"Invalid template name\" or \"RCS entity not configured\"","type":"string"}},"type":"object"},"rcsdocs.RcsProviderError":{"properties":{"action":{"description":"Action suggested to fix the request","type":"string"},"description":{"description":"Description of the error","type":"string"},"errorCode":{"description":"ErrorCode is the HTTP status as a code, e.g. E400, E404, E409, E429","type":"string"},"resources":{"description":"Resources links to documentation about the error; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorResource"},"type":"array","uniqueItems":false},"violations":{"description":"Violations lists the invalid fields of the request; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorViolation"},"type":"array","uniqueItems":false}},"required":["action","description","errorCode","resources","violations"],"type":"object"},"rcsdocs.RcsProviderErrorResource":{"properties":{"name":{"type":"string"},"url":{"type":"string"}},"type":"object"},"rcsdocs.RcsProviderErrorViolation":{"properties":{"property":{"description":"Property is the path of the invalid field","type":"string"},"violation":{"description":"Violation says what is wrong with it","type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/senders/{sender}/launch-status":{"get":{"description":"Get the launch status of a sender per country and mobile network provider. A sender can message all recipients of a network once its provider is `COMPLETED`.","operationId":"get-rcs-sender-launch-status","parameters":[{"description":"RCS sender (must belong to the number)","in":"path","name":"sender","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/senders.RcsSenderLaunchStatus"}}},"description":"Launch status"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Invalid D360-API-KEY"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"RCS not enabled for the number, or the sender does not belong to it"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}}},"description":"Sender not found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Rate limit exceeded"}},"summary":"Get RCS Sender Launch Status","tags":["RCS"]}}}}
```

## List RCS Templates

> List the templates of a sender, without their content. The sender must belong to the number.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"RCS","description":"Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.\n\n**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.\n\n**Typical flow**\n1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).\n2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).\n3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).\n4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.\n\n**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.\n\n**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.\n\n**Errors.** Errors come in four shapes:\n- `{\"message\": \"...\"}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).\n- `{\"error\": \"...\"}`: invalid `D360-API-KEY` (401) or rate limit (429).\n- `{\"detail\": \"...\"}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.\n- `{\"errorCode\": \"E400\", \"description\": \"...\", \"action\": \"...\", \"violations\": [...], \"resources\": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.\n\n**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.\n"}],"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.RcsTemplateListItem":{"properties":{"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"},"rcsdocs.RcsError":{"properties":{"message":{"description":"Message says why the request was refused, e.g. \"sender is required\",\n\"Sender DemoSender does not belong to this account\", \"RCS not enabled for this stack\",\n\"invalid JSON body\", \"Invalid template name\" or \"RCS entity not configured\"","type":"string"}},"type":"object"},"rcsdocs.RcsProviderError":{"properties":{"action":{"description":"Action suggested to fix the request","type":"string"},"description":{"description":"Description of the error","type":"string"},"errorCode":{"description":"ErrorCode is the HTTP status as a code, e.g. E400, E404, E409, E429","type":"string"},"resources":{"description":"Resources links to documentation about the error; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorResource"},"type":"array","uniqueItems":false},"violations":{"description":"Violations lists the invalid fields of the request; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorViolation"},"type":"array","uniqueItems":false}},"required":["action","description","errorCode","resources","violations"],"type":"object"},"rcsdocs.RcsProviderErrorResource":{"properties":{"name":{"type":"string"},"url":{"type":"string"}},"type":"object"},"rcsdocs.RcsProviderErrorViolation":{"properties":{"property":{"description":"Property is the path of the invalid field","type":"string"},"violation":{"description":"Violation says what is wrong with it","type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/senders/{sender}/templates":{"get":{"description":"List the templates of a sender, without their content. The sender must belong to the number.","operationId":"get-rcs-sender-templates","parameters":[{"description":"RCS sender (must belong to the number)","in":"path","name":"sender","required":true,"schema":{"type":"string"}},{"description":"Only templates with this status","in":"query","name":"status","schema":{"enum":["PENDING","APPROVED","REJECTED","SUSPENDED","APPROVED_IN_PROGRESS","APPROVED_PARTIALLY"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/templates.RcsTemplateListItem"},"type":"array"}}},"description":"Templates of the sender"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Invalid D360-API-KEY"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"RCS not enabled for the number, or the sender does not belong to it"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}}},"description":"Sender not found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Rate limit exceeded"}},"summary":"List RCS Templates","tags":["RCS"]}}}}
```

## Create RCS Template

> Create a template for a sender and submit it for approval. Templates are only available for senders that support them, and must be approved before they can be sent (\`PROVIDER\_TEMPLATE\` content in \`POST /rcs/v1/messages\`).\
> \
> \- \`{{placeholder}}\`s can be used in texts, card titles and descriptions, media URLs and suggestions; their values are given as \`parameters\` when sending.\
> \- Follow the approval with \`GET /rcs/v1/senders/{sender}/templates/{templateName}/status\`.\
> \- Up to 1 request per second for creating, editing, registering and deleting templates.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"RCS","description":"Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.\n\n**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.\n\n**Typical flow**\n1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).\n2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).\n3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).\n4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.\n\n**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.\n\n**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.\n\n**Errors.** Errors come in four shapes:\n- `{\"message\": \"...\"}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).\n- `{\"error\": \"...\"}`: invalid `D360-API-KEY` (401) or rate limit (429).\n- `{\"detail\": \"...\"}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.\n- `{\"errorCode\": \"E400\", \"description\": \"...\", \"action\": \"...\", \"violations\": [...], \"resources\": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.\n\n**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.\n"}],"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":{"description":"Content of the template; type selects the content type","oneOf":[{"$ref":"#/components/schemas/templates.RcsTemplateTextContent"},{"$ref":"#/components/schemas/templates.RcsTemplateCardContent"},{"$ref":"#/components/schemas/templates.RcsTemplateCarouselContent"},{"$ref":"#/components/schemas/templates.RcsTemplateTextWithPdfContent"}]},"providers":{"description":"Providers to register the template with (see GET /rcs/v1/templates/template-providers). An empty list registers it with all providers available for the sender","items":{"type":"string"},"type":"array","uniqueItems":false},"templateName":{"description":"TemplateName is unique per sender: 1–20 letters, digits or underscores. Messages use it as templateId","maxLength":20,"minLength":1,"pattern":"^[a-zA-Z0-9_]{1,20}$","type":"string"}},"required":["content","providers","templateName"],"type":"object"},"templates.RcsTemplateTextContent":{"properties":{"suggestions":{"description":"Suggestions shown as chips below the message. Up to 11","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":11,"type":"array","uniqueItems":false},"text":{"description":"Text, up to 2500 characters. Supports {{placeholder}}s","maxLength":2500,"type":"string"},"type":{"enum":["TEXT"],"type":"string"}},"required":["text","type"],"type":"object"},"rcsdocs.RcsReplySuggestion":{"properties":{"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["REPLY"],"type":"string"}},"required":["postbackData","text","type"],"type":"object"},"rcsdocs.RcsOpenUrlSuggestion":{"properties":{"application":{"description":"Application that opens the URL. The browser is used when not set or when the device has no webview support","enum":["BROWSER","WEBVIEW"],"type":"string"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["OPEN_URL"],"type":"string"},"url":{"description":"URL to open. http or https only, 1–2048 characters","maxLength":2048,"minLength":1,"type":"string"},"webviewViewMode":{"description":"WebviewViewMode is the webview size: FULL screen, HALF or TALL (three quarters). Required when application is WEBVIEW","enum":["FULL","HALF","TALL"],"type":"string"}},"required":["postbackData","text","type","url"],"type":"object"},"rcsdocs.RcsDialPhoneSuggestion":{"properties":{"phoneNumber":{"description":"PhoneNumber to dial, digits with an optional leading +, no spaces","pattern":"^\\+?[0-9]\\d{1,14}$","type":"string"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["DIAL_PHONE"],"type":"string"}},"required":["phoneNumber","postbackData","text","type"],"type":"object"},"rcsdocs.RcsShowLocationSuggestion":{"properties":{"label":{"description":"Label of the location. 1–100 characters","maxLength":100,"minLength":1,"type":"string"},"latitude":{"description":"Latitude, -90 to 90","maximum":90,"minimum":-90,"type":"number"},"longitude":{"description":"Longitude, -180 to 180","maximum":180,"minimum":-180,"type":"number"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["SHOW_LOCATION"],"type":"string"}},"required":["latitude","longitude","postbackData","text","type"],"type":"object"},"rcsdocs.RcsRequestLocationSuggestion":{"properties":{"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["REQUEST_LOCATION"],"type":"string"}},"required":["postbackData","text","type"],"type":"object"},"rcsdocs.RcsCreateCalendarEventSuggestion":{"properties":{"description":{"description":"Description of the event. 1–500 characters","maxLength":500,"minLength":1,"type":"string"},"endTime":{"description":"EndTime of the event, yyyy-MM-dd'T'HH:mm:ss.SSSZ. Must be after startTime","type":"string"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"startTime":{"description":"StartTime of the event, yyyy-MM-dd'T'HH:mm:ss.SSSZ. Must be in the future and before endTime","type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"title":{"description":"Title of the event. 1–100 characters","maxLength":100,"minLength":1,"type":"string"},"type":{"enum":["CREATE_CALENDAR_EVENT"],"type":"string"}},"required":["endTime","postbackData","startTime","text","title","type"],"type":"object"},"templates.RcsTemplateCardContent":{"properties":{"alignment":{"description":"Alignment of the media in a HORIZONTAL card","enum":["LEFT","RIGHT"],"type":"string"},"content":{"$ref":"#/components/schemas/rcsdocs.RcsCardBody"},"orientation":{"description":"Orientation of the card","enum":["HORIZONTAL","VERTICAL"],"type":"string"},"suggestions":{"description":"Suggestions shown as chips below the card. Up to 11","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":11,"type":"array","uniqueItems":false},"type":{"enum":["CARD"],"type":"string"}},"required":["alignment","content","orientation","type"],"type":"object"},"rcsdocs.RcsCardBody":{"properties":{"description":{"description":"Description below the title. 1–2000 characters","maxLength":2000,"minLength":1,"type":"string"},"media":{"$ref":"#/components/schemas/rcsdocs.RcsCardMedia"},"suggestions":{"description":"Suggestions shown as buttons on the card. Up to 4","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":4,"type":"array","uniqueItems":false},"title":{"description":"Title, shown in bold. 1–200 characters","maxLength":200,"minLength":1,"type":"string"}},"type":"object"},"rcsdocs.RcsCardMedia":{"properties":{"file":{"$ref":"#/components/schemas/rcsdocs.RcsFile","description":"File is the image or video shown on the card: JPEG, JPG, GIF, PNG, H263, M4V, MP4, MPEG,\nMPEG4 or WEBM. Support for some formats depends on the mobile network operator"},"height":{"description":"Height of the media on the card","enum":["SHORT","MEDIUM","TALL"],"type":"string"},"thumbnail":{"$ref":"#/components/schemas/rcsdocs.RcsFile","description":"Thumbnail shown while a video loads. Video files only"}},"required":["file","height"],"type":"object"},"rcsdocs.RcsFile":{"properties":{"url":{"description":"URL of the file, 1–2048 characters","maxLength":2048,"minLength":1,"type":"string"}},"required":["url"],"type":"object"},"templates.RcsTemplateCarouselContent":{"properties":{"cardWidth":{"description":"CardWidth of every card","enum":["SMALL","MEDIUM"],"type":"string"},"contents":{"description":"Contents are the cards, 2–10","items":{"$ref":"#/components/schemas/rcsdocs.RcsCardBody"},"maxItems":10,"minItems":2,"type":"array","uniqueItems":false},"type":{"enum":["CAROUSEL"],"type":"string"}},"required":["cardWidth","contents","type"],"type":"object"},"templates.RcsTemplateTextWithPdfContent":{"properties":{"messageOrder":{"description":"MessageOrder of the text and the PDF","enum":["TEXT_MESSAGE_AT_TOP","PDF_AT_TOP"],"type":"string"},"suggestions":{"description":"Suggestions shown as chips below the message. Up to 11","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":11,"type":"array","uniqueItems":false},"text":{"description":"Text, up to 1000 characters. Supports {{placeholder}}s","maxLength":1000,"type":"string"},"type":{"enum":["TEXT_WITH_PDF"],"type":"string"},"url":{"description":"URL of the PDF, public, up to 1000 characters and 100 MB","maxLength":1000,"minLength":1,"type":"string"}},"required":["messageOrder","text","type","url"],"type":"object"},"templates.RcsTemplate":{"properties":{"content":{"oneOf":[{"$ref":"#/components/schemas/templates.RcsTemplateTextContent"},{"$ref":"#/components/schemas/templates.RcsTemplateCardContent"},{"$ref":"#/components/schemas/templates.RcsTemplateCarouselContent"},{"$ref":"#/components/schemas/templates.RcsTemplateTextWithPdfContent"}]},"lastUpdate":{"description":"LastUpdate of the template, yyyy-MM-dd'T'HH:mm:ss.SSSZ","type":"string"},"name":{"type":"string"},"status":{"description":"Status of the template across its providers. PENDING: still in review with all; APPROVED: approved by all;\nREJECTED: rejected by all; SUSPENDED: suspended by all; APPROVED_IN_PROGRESS: approved by some, others still\nreviewing; APPROVED_PARTIALLY: approved by some, none still reviewing","enum":["PENDING","APPROVED","REJECTED","SUSPENDED","APPROVED_IN_PROGRESS","APPROVED_PARTIALLY"],"type":"string"},"type":{"description":"Type of the content","enum":["TEXT","CARD","CAROUSEL","TEXT_WITH_PDF"],"type":"string"}},"type":"object"},"rcsdocs.RcsProviderError":{"properties":{"action":{"description":"Action suggested to fix the request","type":"string"},"description":{"description":"Description of the error","type":"string"},"errorCode":{"description":"ErrorCode is the HTTP status as a code, e.g. E400, E404, E409, E429","type":"string"},"resources":{"description":"Resources links to documentation about the error; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorResource"},"type":"array","uniqueItems":false},"violations":{"description":"Violations lists the invalid fields of the request; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorViolation"},"type":"array","uniqueItems":false}},"required":["action","description","errorCode","resources","violations"],"type":"object"},"rcsdocs.RcsProviderErrorResource":{"properties":{"name":{"type":"string"},"url":{"type":"string"}},"type":"object"},"rcsdocs.RcsProviderErrorViolation":{"properties":{"property":{"description":"Property is the path of the invalid field","type":"string"},"violation":{"description":"Violation says what is wrong with it","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"},"rcsdocs.RcsError":{"properties":{"message":{"description":"Message says why the request was refused, e.g. \"sender is required\",\n\"Sender DemoSender does not belong to this account\", \"RCS not enabled for this stack\",\n\"invalid JSON body\", \"Invalid template name\" or \"RCS entity not configured\"","type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/senders/{sender}/templates":{"post":{"description":"Create a template for a sender and submit it for approval. Templates are only available for senders that support them, and must be approved before they can be sent (`PROVIDER_TEMPLATE` content in `POST /rcs/v1/messages`).\n\n- `{{placeholder}}`s can be used in texts, card titles and descriptions, media URLs and suggestions; their values are given as `parameters` when sending.\n- Follow the approval with `GET /rcs/v1/senders/{sender}/templates/{templateName}/status`.\n- Up to 1 request per second for creating, editing, registering and deleting templates.","operationId":"post-rcs-sender-templates","parameters":[{"description":"RCS sender (must belong to the number)","in":"path","name":"sender","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/templates.RcsCreateTemplateRequest","summary":"requestBody","description":"Template"}}},"description":"Template","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/templates.RcsTemplate"}}},"description":"Template created, usually PENDING"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}}},"description":"Invalid template, see violations"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Invalid D360-API-KEY"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"RCS not enabled for the number, or the sender does not belong to it"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}}},"description":"Sender not found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Rate limit exceeded"}},"summary":"Create RCS Template","tags":["RCS"]}}}}
```

## Get RCS Template

> Get a template with its content and overall status.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"RCS","description":"Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.\n\n**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.\n\n**Typical flow**\n1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).\n2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).\n3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).\n4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.\n\n**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.\n\n**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.\n\n**Errors.** Errors come in four shapes:\n- `{\"message\": \"...\"}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).\n- `{\"error\": \"...\"}`: invalid `D360-API-KEY` (401) or rate limit (429).\n- `{\"detail\": \"...\"}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.\n- `{\"errorCode\": \"E400\", \"description\": \"...\", \"action\": \"...\", \"violations\": [...], \"resources\": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.\n\n**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.\n"}],"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":{"oneOf":[{"$ref":"#/components/schemas/templates.RcsTemplateTextContent"},{"$ref":"#/components/schemas/templates.RcsTemplateCardContent"},{"$ref":"#/components/schemas/templates.RcsTemplateCarouselContent"},{"$ref":"#/components/schemas/templates.RcsTemplateTextWithPdfContent"}]},"lastUpdate":{"description":"LastUpdate of the template, yyyy-MM-dd'T'HH:mm:ss.SSSZ","type":"string"},"name":{"type":"string"},"status":{"description":"Status of the template across its providers. PENDING: still in review with all; APPROVED: approved by all;\nREJECTED: rejected by all; SUSPENDED: suspended by all; APPROVED_IN_PROGRESS: approved by some, others still\nreviewing; APPROVED_PARTIALLY: approved by some, none still reviewing","enum":["PENDING","APPROVED","REJECTED","SUSPENDED","APPROVED_IN_PROGRESS","APPROVED_PARTIALLY"],"type":"string"},"type":{"description":"Type of the content","enum":["TEXT","CARD","CAROUSEL","TEXT_WITH_PDF"],"type":"string"}},"type":"object"},"templates.RcsTemplateTextContent":{"properties":{"suggestions":{"description":"Suggestions shown as chips below the message. Up to 11","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":11,"type":"array","uniqueItems":false},"text":{"description":"Text, up to 2500 characters. Supports {{placeholder}}s","maxLength":2500,"type":"string"},"type":{"enum":["TEXT"],"type":"string"}},"required":["text","type"],"type":"object"},"rcsdocs.RcsReplySuggestion":{"properties":{"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["REPLY"],"type":"string"}},"required":["postbackData","text","type"],"type":"object"},"rcsdocs.RcsOpenUrlSuggestion":{"properties":{"application":{"description":"Application that opens the URL. The browser is used when not set or when the device has no webview support","enum":["BROWSER","WEBVIEW"],"type":"string"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["OPEN_URL"],"type":"string"},"url":{"description":"URL to open. http or https only, 1–2048 characters","maxLength":2048,"minLength":1,"type":"string"},"webviewViewMode":{"description":"WebviewViewMode is the webview size: FULL screen, HALF or TALL (three quarters). Required when application is WEBVIEW","enum":["FULL","HALF","TALL"],"type":"string"}},"required":["postbackData","text","type","url"],"type":"object"},"rcsdocs.RcsDialPhoneSuggestion":{"properties":{"phoneNumber":{"description":"PhoneNumber to dial, digits with an optional leading +, no spaces","pattern":"^\\+?[0-9]\\d{1,14}$","type":"string"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["DIAL_PHONE"],"type":"string"}},"required":["phoneNumber","postbackData","text","type"],"type":"object"},"rcsdocs.RcsShowLocationSuggestion":{"properties":{"label":{"description":"Label of the location. 1–100 characters","maxLength":100,"minLength":1,"type":"string"},"latitude":{"description":"Latitude, -90 to 90","maximum":90,"minimum":-90,"type":"number"},"longitude":{"description":"Longitude, -180 to 180","maximum":180,"minimum":-180,"type":"number"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["SHOW_LOCATION"],"type":"string"}},"required":["latitude","longitude","postbackData","text","type"],"type":"object"},"rcsdocs.RcsRequestLocationSuggestion":{"properties":{"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["REQUEST_LOCATION"],"type":"string"}},"required":["postbackData","text","type"],"type":"object"},"rcsdocs.RcsCreateCalendarEventSuggestion":{"properties":{"description":{"description":"Description of the event. 1–500 characters","maxLength":500,"minLength":1,"type":"string"},"endTime":{"description":"EndTime of the event, yyyy-MM-dd'T'HH:mm:ss.SSSZ. Must be after startTime","type":"string"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"startTime":{"description":"StartTime of the event, yyyy-MM-dd'T'HH:mm:ss.SSSZ. Must be in the future and before endTime","type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"title":{"description":"Title of the event. 1–100 characters","maxLength":100,"minLength":1,"type":"string"},"type":{"enum":["CREATE_CALENDAR_EVENT"],"type":"string"}},"required":["endTime","postbackData","startTime","text","title","type"],"type":"object"},"templates.RcsTemplateCardContent":{"properties":{"alignment":{"description":"Alignment of the media in a HORIZONTAL card","enum":["LEFT","RIGHT"],"type":"string"},"content":{"$ref":"#/components/schemas/rcsdocs.RcsCardBody"},"orientation":{"description":"Orientation of the card","enum":["HORIZONTAL","VERTICAL"],"type":"string"},"suggestions":{"description":"Suggestions shown as chips below the card. Up to 11","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":11,"type":"array","uniqueItems":false},"type":{"enum":["CARD"],"type":"string"}},"required":["alignment","content","orientation","type"],"type":"object"},"rcsdocs.RcsCardBody":{"properties":{"description":{"description":"Description below the title. 1–2000 characters","maxLength":2000,"minLength":1,"type":"string"},"media":{"$ref":"#/components/schemas/rcsdocs.RcsCardMedia"},"suggestions":{"description":"Suggestions shown as buttons on the card. Up to 4","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":4,"type":"array","uniqueItems":false},"title":{"description":"Title, shown in bold. 1–200 characters","maxLength":200,"minLength":1,"type":"string"}},"type":"object"},"rcsdocs.RcsCardMedia":{"properties":{"file":{"$ref":"#/components/schemas/rcsdocs.RcsFile","description":"File is the image or video shown on the card: JPEG, JPG, GIF, PNG, H263, M4V, MP4, MPEG,\nMPEG4 or WEBM. Support for some formats depends on the mobile network operator"},"height":{"description":"Height of the media on the card","enum":["SHORT","MEDIUM","TALL"],"type":"string"},"thumbnail":{"$ref":"#/components/schemas/rcsdocs.RcsFile","description":"Thumbnail shown while a video loads. Video files only"}},"required":["file","height"],"type":"object"},"rcsdocs.RcsFile":{"properties":{"url":{"description":"URL of the file, 1–2048 characters","maxLength":2048,"minLength":1,"type":"string"}},"required":["url"],"type":"object"},"templates.RcsTemplateCarouselContent":{"properties":{"cardWidth":{"description":"CardWidth of every card","enum":["SMALL","MEDIUM"],"type":"string"},"contents":{"description":"Contents are the cards, 2–10","items":{"$ref":"#/components/schemas/rcsdocs.RcsCardBody"},"maxItems":10,"minItems":2,"type":"array","uniqueItems":false},"type":{"enum":["CAROUSEL"],"type":"string"}},"required":["cardWidth","contents","type"],"type":"object"},"templates.RcsTemplateTextWithPdfContent":{"properties":{"messageOrder":{"description":"MessageOrder of the text and the PDF","enum":["TEXT_MESSAGE_AT_TOP","PDF_AT_TOP"],"type":"string"},"suggestions":{"description":"Suggestions shown as chips below the message. Up to 11","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":11,"type":"array","uniqueItems":false},"text":{"description":"Text, up to 1000 characters. Supports {{placeholder}}s","maxLength":1000,"type":"string"},"type":{"enum":["TEXT_WITH_PDF"],"type":"string"},"url":{"description":"URL of the PDF, public, up to 1000 characters and 100 MB","maxLength":1000,"minLength":1,"type":"string"}},"required":["messageOrder","text","type","url"],"type":"object"},"rcsdocs.RcsError":{"properties":{"message":{"description":"Message says why the request was refused, e.g. \"sender is required\",\n\"Sender DemoSender does not belong to this account\", \"RCS not enabled for this stack\",\n\"invalid JSON body\", \"Invalid template name\" or \"RCS entity not configured\"","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"},"rcsdocs.RcsProviderError":{"properties":{"action":{"description":"Action suggested to fix the request","type":"string"},"description":{"description":"Description of the error","type":"string"},"errorCode":{"description":"ErrorCode is the HTTP status as a code, e.g. E400, E404, E409, E429","type":"string"},"resources":{"description":"Resources links to documentation about the error; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorResource"},"type":"array","uniqueItems":false},"violations":{"description":"Violations lists the invalid fields of the request; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorViolation"},"type":"array","uniqueItems":false}},"required":["action","description","errorCode","resources","violations"],"type":"object"},"rcsdocs.RcsProviderErrorResource":{"properties":{"name":{"type":"string"},"url":{"type":"string"}},"type":"object"},"rcsdocs.RcsProviderErrorViolation":{"properties":{"property":{"description":"Property is the path of the invalid field","type":"string"},"violation":{"description":"Violation says what is wrong with it","type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/senders/{sender}/templates/{templateName}":{"get":{"description":"Get a template with its content and overall status.","operationId":"get-rcs-sender-template","parameters":[{"description":"RCS sender (must belong to the number)","in":"path","name":"sender","required":true,"schema":{"type":"string"}},{"description":"Template name, 1–20 letters, digits or underscores","in":"path","name":"templateName","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/templates.RcsTemplate"}}},"description":"Template"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"Invalid template name"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Invalid D360-API-KEY"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"RCS not enabled for the number, or the sender does not belong to it"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}}},"description":"Template not found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Rate limit exceeded"}},"summary":"Get RCS Template","tags":["RCS"]}}}}
```

## Edit RCS Template

> Replace the content of a template; it goes through approval again. Only \`PENDING\`, \`REJECTED\` and \`SUSPENDED\` templates can be edited, not \`APPROVED\` ones. The body is the content object itself, not wrapped in \`content\`.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"RCS","description":"Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.\n\n**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.\n\n**Typical flow**\n1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).\n2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).\n3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).\n4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.\n\n**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.\n\n**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.\n\n**Errors.** Errors come in four shapes:\n- `{\"message\": \"...\"}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).\n- `{\"error\": \"...\"}`: invalid `D360-API-KEY` (401) or rate limit (429).\n- `{\"detail\": \"...\"}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.\n- `{\"errorCode\": \"E400\", \"description\": \"...\", \"action\": \"...\", \"violations\": [...], \"resources\": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.\n\n**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.\n"}],"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.RcsTemplateTextContent":{"properties":{"suggestions":{"description":"Suggestions shown as chips below the message. Up to 11","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":11,"type":"array","uniqueItems":false},"text":{"description":"Text, up to 2500 characters. Supports {{placeholder}}s","maxLength":2500,"type":"string"},"type":{"enum":["TEXT"],"type":"string"}},"required":["text","type"],"type":"object"},"rcsdocs.RcsReplySuggestion":{"properties":{"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["REPLY"],"type":"string"}},"required":["postbackData","text","type"],"type":"object"},"rcsdocs.RcsOpenUrlSuggestion":{"properties":{"application":{"description":"Application that opens the URL. The browser is used when not set or when the device has no webview support","enum":["BROWSER","WEBVIEW"],"type":"string"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["OPEN_URL"],"type":"string"},"url":{"description":"URL to open. http or https only, 1–2048 characters","maxLength":2048,"minLength":1,"type":"string"},"webviewViewMode":{"description":"WebviewViewMode is the webview size: FULL screen, HALF or TALL (three quarters). Required when application is WEBVIEW","enum":["FULL","HALF","TALL"],"type":"string"}},"required":["postbackData","text","type","url"],"type":"object"},"rcsdocs.RcsDialPhoneSuggestion":{"properties":{"phoneNumber":{"description":"PhoneNumber to dial, digits with an optional leading +, no spaces","pattern":"^\\+?[0-9]\\d{1,14}$","type":"string"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["DIAL_PHONE"],"type":"string"}},"required":["phoneNumber","postbackData","text","type"],"type":"object"},"rcsdocs.RcsShowLocationSuggestion":{"properties":{"label":{"description":"Label of the location. 1–100 characters","maxLength":100,"minLength":1,"type":"string"},"latitude":{"description":"Latitude, -90 to 90","maximum":90,"minimum":-90,"type":"number"},"longitude":{"description":"Longitude, -180 to 180","maximum":180,"minimum":-180,"type":"number"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["SHOW_LOCATION"],"type":"string"}},"required":["latitude","longitude","postbackData","text","type"],"type":"object"},"rcsdocs.RcsRequestLocationSuggestion":{"properties":{"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["REQUEST_LOCATION"],"type":"string"}},"required":["postbackData","text","type"],"type":"object"},"rcsdocs.RcsCreateCalendarEventSuggestion":{"properties":{"description":{"description":"Description of the event. 1–500 characters","maxLength":500,"minLength":1,"type":"string"},"endTime":{"description":"EndTime of the event, yyyy-MM-dd'T'HH:mm:ss.SSSZ. Must be after startTime","type":"string"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"startTime":{"description":"StartTime of the event, yyyy-MM-dd'T'HH:mm:ss.SSSZ. Must be in the future and before endTime","type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"title":{"description":"Title of the event. 1–100 characters","maxLength":100,"minLength":1,"type":"string"},"type":{"enum":["CREATE_CALENDAR_EVENT"],"type":"string"}},"required":["endTime","postbackData","startTime","text","title","type"],"type":"object"},"templates.RcsTemplateCardContent":{"properties":{"alignment":{"description":"Alignment of the media in a HORIZONTAL card","enum":["LEFT","RIGHT"],"type":"string"},"content":{"$ref":"#/components/schemas/rcsdocs.RcsCardBody"},"orientation":{"description":"Orientation of the card","enum":["HORIZONTAL","VERTICAL"],"type":"string"},"suggestions":{"description":"Suggestions shown as chips below the card. Up to 11","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":11,"type":"array","uniqueItems":false},"type":{"enum":["CARD"],"type":"string"}},"required":["alignment","content","orientation","type"],"type":"object"},"rcsdocs.RcsCardBody":{"properties":{"description":{"description":"Description below the title. 1–2000 characters","maxLength":2000,"minLength":1,"type":"string"},"media":{"$ref":"#/components/schemas/rcsdocs.RcsCardMedia"},"suggestions":{"description":"Suggestions shown as buttons on the card. Up to 4","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":4,"type":"array","uniqueItems":false},"title":{"description":"Title, shown in bold. 1–200 characters","maxLength":200,"minLength":1,"type":"string"}},"type":"object"},"rcsdocs.RcsCardMedia":{"properties":{"file":{"$ref":"#/components/schemas/rcsdocs.RcsFile","description":"File is the image or video shown on the card: JPEG, JPG, GIF, PNG, H263, M4V, MP4, MPEG,\nMPEG4 or WEBM. Support for some formats depends on the mobile network operator"},"height":{"description":"Height of the media on the card","enum":["SHORT","MEDIUM","TALL"],"type":"string"},"thumbnail":{"$ref":"#/components/schemas/rcsdocs.RcsFile","description":"Thumbnail shown while a video loads. Video files only"}},"required":["file","height"],"type":"object"},"rcsdocs.RcsFile":{"properties":{"url":{"description":"URL of the file, 1–2048 characters","maxLength":2048,"minLength":1,"type":"string"}},"required":["url"],"type":"object"},"templates.RcsTemplateCarouselContent":{"properties":{"cardWidth":{"description":"CardWidth of every card","enum":["SMALL","MEDIUM"],"type":"string"},"contents":{"description":"Contents are the cards, 2–10","items":{"$ref":"#/components/schemas/rcsdocs.RcsCardBody"},"maxItems":10,"minItems":2,"type":"array","uniqueItems":false},"type":{"enum":["CAROUSEL"],"type":"string"}},"required":["cardWidth","contents","type"],"type":"object"},"templates.RcsTemplateTextWithPdfContent":{"properties":{"messageOrder":{"description":"MessageOrder of the text and the PDF","enum":["TEXT_MESSAGE_AT_TOP","PDF_AT_TOP"],"type":"string"},"suggestions":{"description":"Suggestions shown as chips below the message. Up to 11","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":11,"type":"array","uniqueItems":false},"text":{"description":"Text, up to 1000 characters. Supports {{placeholder}}s","maxLength":1000,"type":"string"},"type":{"enum":["TEXT_WITH_PDF"],"type":"string"},"url":{"description":"URL of the PDF, public, up to 1000 characters and 100 MB","maxLength":1000,"minLength":1,"type":"string"}},"required":["messageOrder","text","type","url"],"type":"object"},"templates.RcsTemplate":{"properties":{"content":{"oneOf":[{"$ref":"#/components/schemas/templates.RcsTemplateTextContent"},{"$ref":"#/components/schemas/templates.RcsTemplateCardContent"},{"$ref":"#/components/schemas/templates.RcsTemplateCarouselContent"},{"$ref":"#/components/schemas/templates.RcsTemplateTextWithPdfContent"}]},"lastUpdate":{"description":"LastUpdate of the template, yyyy-MM-dd'T'HH:mm:ss.SSSZ","type":"string"},"name":{"type":"string"},"status":{"description":"Status of the template across its providers. PENDING: still in review with all; APPROVED: approved by all;\nREJECTED: rejected by all; SUSPENDED: suspended by all; APPROVED_IN_PROGRESS: approved by some, others still\nreviewing; APPROVED_PARTIALLY: approved by some, none still reviewing","enum":["PENDING","APPROVED","REJECTED","SUSPENDED","APPROVED_IN_PROGRESS","APPROVED_PARTIALLY"],"type":"string"},"type":{"description":"Type of the content","enum":["TEXT","CARD","CAROUSEL","TEXT_WITH_PDF"],"type":"string"}},"type":"object"},"rcsdocs.RcsError":{"properties":{"message":{"description":"Message says why the request was refused, e.g. \"sender is required\",\n\"Sender DemoSender does not belong to this account\", \"RCS not enabled for this stack\",\n\"invalid JSON body\", \"Invalid template name\" or \"RCS entity not configured\"","type":"string"}},"type":"object"},"rcsdocs.RcsProviderError":{"properties":{"action":{"description":"Action suggested to fix the request","type":"string"},"description":{"description":"Description of the error","type":"string"},"errorCode":{"description":"ErrorCode is the HTTP status as a code, e.g. E400, E404, E409, E429","type":"string"},"resources":{"description":"Resources links to documentation about the error; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorResource"},"type":"array","uniqueItems":false},"violations":{"description":"Violations lists the invalid fields of the request; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorViolation"},"type":"array","uniqueItems":false}},"required":["action","description","errorCode","resources","violations"],"type":"object"},"rcsdocs.RcsProviderErrorResource":{"properties":{"name":{"type":"string"},"url":{"type":"string"}},"type":"object"},"rcsdocs.RcsProviderErrorViolation":{"properties":{"property":{"description":"Property is the path of the invalid field","type":"string"},"violation":{"description":"Violation says what is wrong with it","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/senders/{sender}/templates/{templateName}":{"put":{"description":"Replace the content of a template; it goes through approval again. Only `PENDING`, `REJECTED` and `SUSPENDED` templates can be edited, not `APPROVED` ones. The body is the content object itself, not wrapped in `content`.","operationId":"put-rcs-sender-template","parameters":[{"description":"RCS sender (must belong to the number)","in":"path","name":"sender","required":true,"schema":{"type":"string"}},{"description":"Template name, 1–20 letters, digits or underscores","in":"path","name":"templateName","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/templates.RcsTemplateTextContent","summary":"requestBody","description":"New content: a TEXT, CARD, CAROUSEL or TEXT_WITH_PDF content object"},{"$ref":"#/components/schemas/templates.RcsTemplateCardContent","summary":"requestBody","description":"New content: a TEXT, CARD, CAROUSEL or TEXT_WITH_PDF content object"},{"$ref":"#/components/schemas/templates.RcsTemplateCarouselContent","summary":"requestBody","description":"New content: a TEXT, CARD, CAROUSEL or TEXT_WITH_PDF content object"},{"$ref":"#/components/schemas/templates.RcsTemplateTextWithPdfContent","summary":"requestBody","description":"New content: a TEXT, CARD, CAROUSEL or TEXT_WITH_PDF content object"}]}}},"description":"New content: a TEXT, CARD, CAROUSEL or TEXT_WITH_PDF content object | New content: a TEXT, CARD, CAROUSEL or TEXT_WITH_PDF content object | New content: a TEXT, CARD, CAROUSEL or TEXT_WITH_PDF content object | New content: a TEXT, CARD, CAROUSEL or TEXT_WITH_PDF content object","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/templates.RcsTemplate"}}},"description":"Template updated"},"400":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsError"},{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}]}}},"description":"Invalid template name (body `message`), or rejected by the RCS provider: invalid content, or the template is APPROVED (body `errorCode`)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Invalid D360-API-KEY"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"RCS not enabled for the number, or the sender does not belong to it"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}}},"description":"Template not found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Rate limit exceeded"}},"summary":"Edit RCS Template","tags":["RCS"]}}}}
```

## Delete RCS Template

> Delete a template. Messages sent with it afterwards are rejected.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"RCS","description":"Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.\n\n**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.\n\n**Typical flow**\n1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).\n2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).\n3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).\n4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.\n\n**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.\n\n**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.\n\n**Errors.** Errors come in four shapes:\n- `{\"message\": \"...\"}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).\n- `{\"error\": \"...\"}`: invalid `D360-API-KEY` (401) or rate limit (429).\n- `{\"detail\": \"...\"}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.\n- `{\"errorCode\": \"E400\", \"description\": \"...\", \"action\": \"...\", \"violations\": [...], \"resources\": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.\n\n**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.\n"}],"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":{"rcsdocs.RcsError":{"properties":{"message":{"description":"Message says why the request was refused, e.g. \"sender is required\",\n\"Sender DemoSender does not belong to this account\", \"RCS not enabled for this stack\",\n\"invalid JSON body\", \"Invalid template name\" or \"RCS entity not configured\"","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"},"rcsdocs.RcsProviderError":{"properties":{"action":{"description":"Action suggested to fix the request","type":"string"},"description":{"description":"Description of the error","type":"string"},"errorCode":{"description":"ErrorCode is the HTTP status as a code, e.g. E400, E404, E409, E429","type":"string"},"resources":{"description":"Resources links to documentation about the error; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorResource"},"type":"array","uniqueItems":false},"violations":{"description":"Violations lists the invalid fields of the request; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorViolation"},"type":"array","uniqueItems":false}},"required":["action","description","errorCode","resources","violations"],"type":"object"},"rcsdocs.RcsProviderErrorResource":{"properties":{"name":{"type":"string"},"url":{"type":"string"}},"type":"object"},"rcsdocs.RcsProviderErrorViolation":{"properties":{"property":{"description":"Property is the path of the invalid field","type":"string"},"violation":{"description":"Violation says what is wrong with it","type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/senders/{sender}/templates/{templateName}":{"delete":{"description":"Delete a template. Messages sent with it afterwards are rejected.","operationId":"delete-rcs-sender-template","parameters":[{"description":"RCS sender (must belong to the number)","in":"path","name":"sender","required":true,"schema":{"type":"string"}},{"description":"Template name, 1–20 letters, digits or underscores","in":"path","name":"templateName","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Template deleted, no body"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"Invalid template name"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Invalid D360-API-KEY"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"RCS not enabled for the number, or the sender does not belong to it"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}}},"description":"Template not found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Rate limit exceeded"}},"summary":"Delete RCS Template","tags":["RCS"]}}}}
```

## Register RCS Template with More Providers

> Submit an existing template to more providers, e.g. when the sender is launched with a new provider. List only providers the template is not registered with yet.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"RCS","description":"Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.\n\n**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.\n\n**Typical flow**\n1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).\n2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).\n3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).\n4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.\n\n**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.\n\n**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.\n\n**Errors.** Errors come in four shapes:\n- `{\"message\": \"...\"}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).\n- `{\"error\": \"...\"}`: invalid `D360-API-KEY` (401) or rate limit (429).\n- `{\"detail\": \"...\"}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.\n- `{\"errorCode\": \"E400\", \"description\": \"...\", \"action\": \"...\", \"violations\": [...], \"resources\": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.\n\n**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.\n"}],"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 to register the template with, only ones it is not registered with yet. At least one","items":{"type":"string"},"minItems":1,"type":"array","uniqueItems":false}},"required":["providers"],"type":"object"},"templates.RcsTemplate":{"properties":{"content":{"oneOf":[{"$ref":"#/components/schemas/templates.RcsTemplateTextContent"},{"$ref":"#/components/schemas/templates.RcsTemplateCardContent"},{"$ref":"#/components/schemas/templates.RcsTemplateCarouselContent"},{"$ref":"#/components/schemas/templates.RcsTemplateTextWithPdfContent"}]},"lastUpdate":{"description":"LastUpdate of the template, yyyy-MM-dd'T'HH:mm:ss.SSSZ","type":"string"},"name":{"type":"string"},"status":{"description":"Status of the template across its providers. PENDING: still in review with all; APPROVED: approved by all;\nREJECTED: rejected by all; SUSPENDED: suspended by all; APPROVED_IN_PROGRESS: approved by some, others still\nreviewing; APPROVED_PARTIALLY: approved by some, none still reviewing","enum":["PENDING","APPROVED","REJECTED","SUSPENDED","APPROVED_IN_PROGRESS","APPROVED_PARTIALLY"],"type":"string"},"type":{"description":"Type of the content","enum":["TEXT","CARD","CAROUSEL","TEXT_WITH_PDF"],"type":"string"}},"type":"object"},"templates.RcsTemplateTextContent":{"properties":{"suggestions":{"description":"Suggestions shown as chips below the message. Up to 11","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":11,"type":"array","uniqueItems":false},"text":{"description":"Text, up to 2500 characters. Supports {{placeholder}}s","maxLength":2500,"type":"string"},"type":{"enum":["TEXT"],"type":"string"}},"required":["text","type"],"type":"object"},"rcsdocs.RcsReplySuggestion":{"properties":{"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["REPLY"],"type":"string"}},"required":["postbackData","text","type"],"type":"object"},"rcsdocs.RcsOpenUrlSuggestion":{"properties":{"application":{"description":"Application that opens the URL. The browser is used when not set or when the device has no webview support","enum":["BROWSER","WEBVIEW"],"type":"string"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["OPEN_URL"],"type":"string"},"url":{"description":"URL to open. http or https only, 1–2048 characters","maxLength":2048,"minLength":1,"type":"string"},"webviewViewMode":{"description":"WebviewViewMode is the webview size: FULL screen, HALF or TALL (three quarters). Required when application is WEBVIEW","enum":["FULL","HALF","TALL"],"type":"string"}},"required":["postbackData","text","type","url"],"type":"object"},"rcsdocs.RcsDialPhoneSuggestion":{"properties":{"phoneNumber":{"description":"PhoneNumber to dial, digits with an optional leading +, no spaces","pattern":"^\\+?[0-9]\\d{1,14}$","type":"string"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["DIAL_PHONE"],"type":"string"}},"required":["phoneNumber","postbackData","text","type"],"type":"object"},"rcsdocs.RcsShowLocationSuggestion":{"properties":{"label":{"description":"Label of the location. 1–100 characters","maxLength":100,"minLength":1,"type":"string"},"latitude":{"description":"Latitude, -90 to 90","maximum":90,"minimum":-90,"type":"number"},"longitude":{"description":"Longitude, -180 to 180","maximum":180,"minimum":-180,"type":"number"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["SHOW_LOCATION"],"type":"string"}},"required":["latitude","longitude","postbackData","text","type"],"type":"object"},"rcsdocs.RcsRequestLocationSuggestion":{"properties":{"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"type":{"enum":["REQUEST_LOCATION"],"type":"string"}},"required":["postbackData","text","type"],"type":"object"},"rcsdocs.RcsCreateCalendarEventSuggestion":{"properties":{"description":{"description":"Description of the event. 1–500 characters","maxLength":500,"minLength":1,"type":"string"},"endTime":{"description":"EndTime of the event, yyyy-MM-dd'T'HH:mm:ss.SSSZ. Must be after startTime","type":"string"},"postbackData":{"description":"PostbackData is sent back to you when the recipient taps the suggestion. 1–2024 characters","maxLength":2024,"minLength":1,"type":"string"},"startTime":{"description":"StartTime of the event, yyyy-MM-dd'T'HH:mm:ss.SSSZ. Must be in the future and before endTime","type":"string"},"text":{"description":"Text of the chip. 1–25 characters","maxLength":25,"minLength":1,"type":"string"},"title":{"description":"Title of the event. 1–100 characters","maxLength":100,"minLength":1,"type":"string"},"type":{"enum":["CREATE_CALENDAR_EVENT"],"type":"string"}},"required":["endTime","postbackData","startTime","text","title","type"],"type":"object"},"templates.RcsTemplateCardContent":{"properties":{"alignment":{"description":"Alignment of the media in a HORIZONTAL card","enum":["LEFT","RIGHT"],"type":"string"},"content":{"$ref":"#/components/schemas/rcsdocs.RcsCardBody"},"orientation":{"description":"Orientation of the card","enum":["HORIZONTAL","VERTICAL"],"type":"string"},"suggestions":{"description":"Suggestions shown as chips below the card. Up to 11","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":11,"type":"array","uniqueItems":false},"type":{"enum":["CARD"],"type":"string"}},"required":["alignment","content","orientation","type"],"type":"object"},"rcsdocs.RcsCardBody":{"properties":{"description":{"description":"Description below the title. 1–2000 characters","maxLength":2000,"minLength":1,"type":"string"},"media":{"$ref":"#/components/schemas/rcsdocs.RcsCardMedia"},"suggestions":{"description":"Suggestions shown as buttons on the card. Up to 4","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":4,"type":"array","uniqueItems":false},"title":{"description":"Title, shown in bold. 1–200 characters","maxLength":200,"minLength":1,"type":"string"}},"type":"object"},"rcsdocs.RcsCardMedia":{"properties":{"file":{"$ref":"#/components/schemas/rcsdocs.RcsFile","description":"File is the image or video shown on the card: JPEG, JPG, GIF, PNG, H263, M4V, MP4, MPEG,\nMPEG4 or WEBM. Support for some formats depends on the mobile network operator"},"height":{"description":"Height of the media on the card","enum":["SHORT","MEDIUM","TALL"],"type":"string"},"thumbnail":{"$ref":"#/components/schemas/rcsdocs.RcsFile","description":"Thumbnail shown while a video loads. Video files only"}},"required":["file","height"],"type":"object"},"rcsdocs.RcsFile":{"properties":{"url":{"description":"URL of the file, 1–2048 characters","maxLength":2048,"minLength":1,"type":"string"}},"required":["url"],"type":"object"},"templates.RcsTemplateCarouselContent":{"properties":{"cardWidth":{"description":"CardWidth of every card","enum":["SMALL","MEDIUM"],"type":"string"},"contents":{"description":"Contents are the cards, 2–10","items":{"$ref":"#/components/schemas/rcsdocs.RcsCardBody"},"maxItems":10,"minItems":2,"type":"array","uniqueItems":false},"type":{"enum":["CAROUSEL"],"type":"string"}},"required":["cardWidth","contents","type"],"type":"object"},"templates.RcsTemplateTextWithPdfContent":{"properties":{"messageOrder":{"description":"MessageOrder of the text and the PDF","enum":["TEXT_MESSAGE_AT_TOP","PDF_AT_TOP"],"type":"string"},"suggestions":{"description":"Suggestions shown as chips below the message. Up to 11","items":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsReplySuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsOpenUrlSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsDialPhoneSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsShowLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsRequestLocationSuggestion"},{"$ref":"#/components/schemas/rcsdocs.RcsCreateCalendarEventSuggestion"}]},"maxItems":11,"type":"array","uniqueItems":false},"text":{"description":"Text, up to 1000 characters. Supports {{placeholder}}s","maxLength":1000,"type":"string"},"type":{"enum":["TEXT_WITH_PDF"],"type":"string"},"url":{"description":"URL of the PDF, public, up to 1000 characters and 100 MB","maxLength":1000,"minLength":1,"type":"string"}},"required":["messageOrder","text","type","url"],"type":"object"},"rcsdocs.RcsError":{"properties":{"message":{"description":"Message says why the request was refused, e.g. \"sender is required\",\n\"Sender DemoSender does not belong to this account\", \"RCS not enabled for this stack\",\n\"invalid JSON body\", \"Invalid template name\" or \"RCS entity not configured\"","type":"string"}},"type":"object"},"rcsdocs.RcsProviderError":{"properties":{"action":{"description":"Action suggested to fix the request","type":"string"},"description":{"description":"Description of the error","type":"string"},"errorCode":{"description":"ErrorCode is the HTTP status as a code, e.g. E400, E404, E409, E429","type":"string"},"resources":{"description":"Resources links to documentation about the error; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorResource"},"type":"array","uniqueItems":false},"violations":{"description":"Violations lists the invalid fields of the request; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorViolation"},"type":"array","uniqueItems":false}},"required":["action","description","errorCode","resources","violations"],"type":"object"},"rcsdocs.RcsProviderErrorResource":{"properties":{"name":{"type":"string"},"url":{"type":"string"}},"type":"object"},"rcsdocs.RcsProviderErrorViolation":{"properties":{"property":{"description":"Property is the path of the invalid field","type":"string"},"violation":{"description":"Violation says what is wrong with it","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/senders/{sender}/templates/{templateName}/register":{"patch":{"description":"Submit an existing template to more providers, e.g. when the sender is launched with a new provider. List only providers the template is not registered with yet.","operationId":"patch-rcs-sender-template-register","parameters":[{"description":"RCS sender (must belong to the number)","in":"path","name":"sender","required":true,"schema":{"type":"string"}},{"description":"Template name, 1–20 letters, digits or underscores","in":"path","name":"templateName","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/templates.RcsRegisterTemplateRequest","summary":"requestBody","description":"Providers to add"}}},"description":"Providers to add","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/templates.RcsTemplate"}}},"description":"Template registered"},"400":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/rcsdocs.RcsError"},{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}]}}},"description":"Invalid template name (body `message`), or rejected by the RCS provider: invalid providers, see violations (body `errorCode`)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Invalid D360-API-KEY"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"RCS not enabled for the number, or the sender does not belong to it"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}}},"description":"Template not found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Rate limit exceeded"}},"summary":"Register RCS Template with More Providers","tags":["RCS"]}}}}
```

## Get RCS Template Status

> Get the approval status of a template per country and provider.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"RCS","description":"Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.\n\n**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.\n\n**Typical flow**\n1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).\n2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).\n3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).\n4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.\n\n**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.\n\n**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.\n\n**Errors.** Errors come in four shapes:\n- `{\"message\": \"...\"}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).\n- `{\"error\": \"...\"}`: invalid `D360-API-KEY` (401) or rate limit (429).\n- `{\"detail\": \"...\"}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.\n- `{\"errorCode\": \"E400\", \"description\": \"...\", \"action\": \"...\", \"violations\": [...], \"resources\": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.\n\n**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.\n"}],"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":{"description":"CountryCode, ISO 3166-1 alpha-2","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"},"rcsdocs.RcsError":{"properties":{"message":{"description":"Message says why the request was refused, e.g. \"sender is required\",\n\"Sender DemoSender does not belong to this account\", \"RCS not enabled for this stack\",\n\"invalid JSON body\", \"Invalid template name\" or \"RCS entity not configured\"","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"},"rcsdocs.RcsProviderError":{"properties":{"action":{"description":"Action suggested to fix the request","type":"string"},"description":{"description":"Description of the error","type":"string"},"errorCode":{"description":"ErrorCode is the HTTP status as a code, e.g. E400, E404, E409, E429","type":"string"},"resources":{"description":"Resources links to documentation about the error; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorResource"},"type":"array","uniqueItems":false},"violations":{"description":"Violations lists the invalid fields of the request; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorViolation"},"type":"array","uniqueItems":false}},"required":["action","description","errorCode","resources","violations"],"type":"object"},"rcsdocs.RcsProviderErrorResource":{"properties":{"name":{"type":"string"},"url":{"type":"string"}},"type":"object"},"rcsdocs.RcsProviderErrorViolation":{"properties":{"property":{"description":"Property is the path of the invalid field","type":"string"},"violation":{"description":"Violation says what is wrong with it","type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/senders/{sender}/templates/{templateName}/status":{"get":{"description":"Get the approval status of a template per country and provider.","operationId":"get-rcs-sender-template-status","parameters":[{"description":"RCS sender (must belong to the number)","in":"path","name":"sender","required":true,"schema":{"type":"string"}},{"description":"Template name, 1–20 letters, digits or underscores","in":"path","name":"templateName","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/templates.RcsTemplateStatusResponse"}}},"description":"Approval status"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"Invalid template name"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Invalid D360-API-KEY"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"RCS not enabled for the number, or the sender does not belong to it"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}}},"description":"Template not found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Rate limit exceeded"}},"summary":"Get RCS Template Status","tags":["RCS"]}}}}
```

## List RCS Sender Test Numbers

> List the test numbers of a sender, newest first. Statuses can lag behind; the status shows whether the tester accepted the invitation.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"RCS","description":"Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.\n\n**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.\n\n**Typical flow**\n1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).\n2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).\n3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).\n4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.\n\n**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.\n\n**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.\n\n**Errors.** Errors come in four shapes:\n- `{\"message\": \"...\"}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).\n- `{\"error\": \"...\"}`: invalid `D360-API-KEY` (401) or rate limit (429).\n- `{\"detail\": \"...\"}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.\n- `{\"errorCode\": \"E400\", \"description\": \"...\", \"action\": \"...\", \"violations\": [...], \"resources\": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.\n\n**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.\n"}],"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":{"senders.RcsTestNumbersResponse":{"properties":{"paging":{"$ref":"#/components/schemas/senders.RcsPaging"},"results":{"items":{"$ref":"#/components/schemas/senders.RcsTestNumber"},"type":"array","uniqueItems":false}},"type":"object"},"senders.RcsPaging":{"properties":{"page":{"type":"integer"},"size":{"type":"integer"},"totalPages":{"type":"integer"},"totalResults":{"type":"integer"}},"type":"object"},"senders.RcsTestNumber":{"properties":{"primary":{"type":"boolean"},"status":{"description":"Status: PENDING; WAITING_FOR_TESTER_ACCEPTANCE the invitation was sent; APPROVED test messages can be sent;\nEXPIRED the invitation was not accepted within 24 hours; UNSUPPORTED the number can't use RCS; FAILED contact support","enum":["PENDING","WAITING_FOR_TESTER_ACCEPTANCE","APPROVED","EXPIRED","UNSUPPORTED","FAILED"],"type":"string"},"testNumber":{"type":"string"},"updatedAt":{"type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"},"rcsdocs.RcsError":{"properties":{"message":{"description":"Message says why the request was refused, e.g. \"sender is required\",\n\"Sender DemoSender does not belong to this account\", \"RCS not enabled for this stack\",\n\"invalid JSON body\", \"Invalid template name\" or \"RCS entity not configured\"","type":"string"}},"type":"object"},"rcsdocs.RcsProviderError":{"properties":{"action":{"description":"Action suggested to fix the request","type":"string"},"description":{"description":"Description of the error","type":"string"},"errorCode":{"description":"ErrorCode is the HTTP status as a code, e.g. E400, E404, E409, E429","type":"string"},"resources":{"description":"Resources links to documentation about the error; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorResource"},"type":"array","uniqueItems":false},"violations":{"description":"Violations lists the invalid fields of the request; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorViolation"},"type":"array","uniqueItems":false}},"required":["action","description","errorCode","resources","violations"],"type":"object"},"rcsdocs.RcsProviderErrorResource":{"properties":{"name":{"type":"string"},"url":{"type":"string"}},"type":"object"},"rcsdocs.RcsProviderErrorViolation":{"properties":{"property":{"description":"Property is the path of the invalid field","type":"string"},"violation":{"description":"Violation says what is wrong with it","type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/senders/{sender}/test-numbers":{"get":{"description":"List the test numbers of a sender, newest first. Statuses can lag behind; the status shows whether the tester accepted the invitation.","operationId":"get-rcs-sender-test-numbers","parameters":[{"description":"RCS sender (must belong to the number)","in":"path","name":"sender","required":true,"schema":{"type":"string"}},{"description":"Page, from 0","in":"query","name":"page","schema":{"default":0,"minimum":0,"type":"integer"}},{"description":"Page size, 1–100","in":"query","name":"size","schema":{"default":20,"maximum":100,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/senders.RcsTestNumbersResponse"}}},"description":"Test numbers"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Invalid D360-API-KEY"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"RCS not enabled for the number, or the sender does not belong to it"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}}},"description":"Sender not found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Rate limit exceeded"}},"summary":"List RCS Sender Test Numbers","tags":["RCS"]}}}}
```

## Add RCS Sender Test Number

> Invite a phone number to test the sender before it is launched. The tester must accept the invitation on the device within 24 hours; the number is then \`APPROVED\` and can receive messages from the sender.\
> \
> Up to 20 invitations per sender per day and 200 in total.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"RCS","description":"Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.\n\n**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.\n\n**Typical flow**\n1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).\n2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).\n3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).\n4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.\n\n**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.\n\n**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.\n\n**Errors.** Errors come in four shapes:\n- `{\"message\": \"...\"}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).\n- `{\"error\": \"...\"}`: invalid `D360-API-KEY` (401) or rate limit (429).\n- `{\"detail\": \"...\"}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.\n- `{\"errorCode\": \"E400\", \"description\": \"...\", \"action\": \"...\", \"violations\": [...], \"resources\": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.\n\n**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.\n"}],"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":{"senders.RcsAddTestNumberRequest":{"properties":{"primary":{"description":"Primary marks the number as the primary test number. A number is primary for one sender only. Default false","type":"boolean"},"testNumber":{"description":"TestNumber in international format, + optional","pattern":"^\\+?[1-9]\\d{1,14}$","type":"string"}},"required":["testNumber"],"type":"object"},"senders.RcsAddTestNumberResponse":{"properties":{"senderName":{"type":"string"},"status":{"type":"string"},"testNumber":{"type":"string"}},"type":"object"},"rcsdocs.RcsProviderError":{"properties":{"action":{"description":"Action suggested to fix the request","type":"string"},"description":{"description":"Description of the error","type":"string"},"errorCode":{"description":"ErrorCode is the HTTP status as a code, e.g. E400, E404, E409, E429","type":"string"},"resources":{"description":"Resources links to documentation about the error; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorResource"},"type":"array","uniqueItems":false},"violations":{"description":"Violations lists the invalid fields of the request; may be empty","items":{"$ref":"#/components/schemas/rcsdocs.RcsProviderErrorViolation"},"type":"array","uniqueItems":false}},"required":["action","description","errorCode","resources","violations"],"type":"object"},"rcsdocs.RcsProviderErrorResource":{"properties":{"name":{"type":"string"},"url":{"type":"string"}},"type":"object"},"rcsdocs.RcsProviderErrorViolation":{"properties":{"property":{"description":"Property is the path of the invalid field","type":"string"},"violation":{"description":"Violation says what is wrong with it","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"},"rcsdocs.RcsError":{"properties":{"message":{"description":"Message says why the request was refused, e.g. \"sender is required\",\n\"Sender DemoSender does not belong to this account\", \"RCS not enabled for this stack\",\n\"invalid JSON body\", \"Invalid template name\" or \"RCS entity not configured\"","type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/senders/{sender}/test-numbers":{"post":{"description":"Invite a phone number to test the sender before it is launched. The tester must accept the invitation on the device within 24 hours; the number is then `APPROVED` and can receive messages from the sender.\n\nUp to 20 invitations per sender per day and 200 in total.","operationId":"post-rcs-sender-test-numbers","parameters":[{"description":"RCS sender (must belong to the number)","in":"path","name":"sender","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/senders.RcsAddTestNumberRequest","summary":"requestBody","description":"Test number"}}},"description":"Test number","required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/senders.RcsAddTestNumberResponse"}}},"description":"Invitation is being sent"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}}},"description":"Invalid number, see violations"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Invalid D360-API-KEY"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"RCS not enabled for the number, or the sender does not belong to it"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}}},"description":"Sender not found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsProviderError"}}},"description":"Conflicts with an existing test number, see violations"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Rate limit exceeded"}},"summary":"Add RCS Sender Test Number","tags":["RCS"]}}}}
```

## List RCS Template Providers

> List the providers a sender's templates can be registered with, optionally for one country.

```json
{"openapi":"3.1.0","info":{"title":"Messaging API","version":"1.56.2"},"tags":[{"name":"RCS","description":"Send and receive RCS (Rich Communication Services) messages: rich text, files, cards, carousels and suggested replies and actions, delivered to the recipient's native messaging app.\n\n**Getting access.** RCS is enabled per number by 360dialog. Until it is, every RCS route answers `403 RCS not enabled for this stack`. All routes use the number's `D360-API-KEY`, the same as WhatsApp routes.\n\n**Typical flow**\n1. Create an RCS sender (`POST /rcs/v1/senders`) or ask 360dialog to attach an existing one, then follow its launch status (`GET /rcs/v1/senders/{sender}/launch-status`). Until the sender is launched, it can only message its test numbers (`/rcs/v1/senders/{sender}/test-numbers`).\n2. Set the webhook URL for the number (`PUT /rcs/v1/configs/webhook`) to receive inbound messages, delivery reports and seen reports (see **RCS Webhooks**).\n3. Optionally check that recipients can receive RCS (`POST /rcs/v1/capability-check/query`).\n4. Send messages (`POST /rcs/v1/messages`) and follow them through the webhooks, or through `GET /rcs/v1/reports` and `GET /rcs/v1/logs`.\n\n**Senders.** Every request that names a sender (in the path, the `sender` query parameter or the body) is checked: the sender must belong to the number, otherwise the request is refused with `403 Sender <name> does not belong to this account`. A request that needs a sender and has none gets `400 sender is required`.\n\n**Rate limit.** By default 100 requests per second per number, shared by all RCS routes; 360dialog can change it per number. Above it, requests get `429 Too many requests for one number`. A send request counts once however many messages it holds.\n\n**Errors.** Errors come in four shapes:\n- `{\"message\": \"...\"}`: 360dialog refused the request before sending it on (missing or foreign sender, invalid body or template name, RCS not enabled).\n- `{\"error\": \"...\"}`: invalid `D360-API-KEY` (401) or rate limit (429).\n- `{\"detail\": \"...\"}`: sender creation and listing and the webhook configuration, e.g. `409 Sender limit reached for this account`.\n- `{\"errorCode\": \"E400\", \"description\": \"...\", \"action\": \"...\", \"violations\": [...], \"resources\": [...]}`: the RCS provider rejected the request; `violations` lists the invalid fields. The body is passed through unchanged.\n\n**Message failures** are reported in delivery reports, not in the send answer: `status` says what happened and `error` why. Common errors: 7002 the recipient can't receive RCS, 7003 the recipient blocked the sender, 7005 the sender is not launched and the recipient is not a test number, 7018 invalid content.\n"}],"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":{"description":"Providers available for the sender","items":{"type":"string"},"type":"array","uniqueItems":false}},"type":"object"},"rcsdocs.RcsError":{"properties":{"message":{"description":"Message says why the request was refused, e.g. \"sender is required\",\n\"Sender DemoSender does not belong to this account\", \"RCS not enabled for this stack\",\n\"invalid JSON body\", \"Invalid template name\" or \"RCS entity not configured\"","type":"string"}},"type":"object"},"utils.ErrorResp":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/rcs/v1/templates/template-providers":{"get":{"description":"List the providers a sender's templates can be registered with, optionally for one country.","operationId":"get-rcs-template-providers","parameters":[{"description":"RCS sender (must belong to the number)","in":"query","name":"sender","required":true,"schema":{"type":"string"}},{"description":"Country, ISO 3166-1 alpha-2, e.g. IN","in":"query","name":"countryCode","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/templates.RcsTemplateProvidersResponse"}}},"description":"Providers"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"Missing sender"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Invalid D360-API-KEY"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rcsdocs.RcsError"}}},"description":"RCS not enabled for the number, or the sender does not belong to it"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/utils.ErrorResp"}}},"description":"Rate limit exceeded"}},"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.
