---
title: "Validate an RCS card payload without creating anything (Flow Builder V2)"
description: "Thin wrapper around the same pure validation used by templates/create — runs every RCS card limit check (title/subtitle/body length, ≤4 buttons, per-type title length, URL/phone format) with NO database write and NO Twilio call, so a card-authoring UI can show inline errors on every keystroke. Authenticated workspace user (Bearer).\n"
---

> Documentation Index
> Fetch the complete documentation index at: https://developer.channelautomations.com/llms.txt
> Use this file to discover all available pages before exploring further.

Path: Channel Automation API › RCS

`POST /api/rcs/workspaces/{workspaceId}/templates/validate`

Thin wrapper around the same pure validation used by templates/create — runs every RCS card limit check (title/subtitle/body length, ≤4 buttons, per-type title length, URL/phone format) with NO database write and NO Twilio call, so a card-authoring UI can show inline errors on every keystroke. Authenticated workspace user (Bearer).

## Authentication

- `BearerAuth`, http, header `Authorization`, format `JWT`

## Path parameters

- `workspaceId` (`post/api/rcs/workspaces/workspaceId/templates/validate.path.workspaceId`; string, required)

## Request body

_Required._

- `label` (`post/api/rcs/workspaces/workspaceId/templates/validate.label`; string, required)
- `card` (`post/api/rcs/workspaces/workspaceId/templates/validate.card`; object, required)
  - `title` (`post/api/rcs/workspaces/workspaceId/templates/validate.card.title`; string, optional)
  - `subtitle` (`post/api/rcs/workspaces/workspaceId/templates/validate.card.subtitle`; string, optional)
  - `body` (`post/api/rcs/workspaces/workspaceId/templates/validate.card.body`; string, optional)
  - `media` (`post/api/rcs/workspaces/workspaceId/templates/validate.card.media`; string, optional)
  - `buttons` (`post/api/rcs/workspaces/workspaceId/templates/validate.card.buttons`; array<object>, optional)
    - `type` (`post/api/rcs/workspaces/workspaceId/templates/validate.card.buttons.type`; string, optional)
      - one of `"QUICK_REPLY"`, `"URL"`, `"PHONE_NUMBER"`
    - `title` (`post/api/rcs/workspaces/workspaceId/templates/validate.card.buttons.title`; string, optional)
    - `url` (`post/api/rcs/workspaces/workspaceId/templates/validate.card.buttons.url`; string, optional)
    - `phone` (`post/api/rcs/workspaces/workspaceId/templates/validate.card.buttons.phone`; string, optional)
- `smsFallback` (`post/api/rcs/workspaces/workspaceId/templates/validate.smsFallback`; string, optional)

## Example request

```json
{
  "label": "string",
  "smsFallback": "string",
  "card": {
    "title": "string",
    "subtitle": "string",
    "body": "string",
    "media": "string",
    "buttons": [
      {
        "type": "QUICK_REPLY",
        "title": "string",
        "url": "string",
        "phone": "string"
      }
    ]
  }
}
```

## Code samples

### cURL

```bash
curl --request POST \
  --url 'https://api.channelautomation.com/api/rcs/workspaces/<workspaceId>/templates/validate' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "label": "string",
  "smsFallback": "string",
  "card": {
    "title": "string",
    "subtitle": "string",
    "body": "string",
    "media": "string",
    "buttons": [
      {
        "type": "QUICK_REPLY",
        "title": "string",
        "url": "string",
        "phone": "string"
      }
    ]
  }
}
'
```

### TypeScript

```typescript
const url = 'https://api.channelautomation.com/api/rcs/workspaces/<workspaceId>/templates/validate';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json', Authorization: 'Bearer <token>'},
  body: JSON.stringify({
    label: 'string',
    smsFallback: 'string',
    card: {
      title: 'string',
      subtitle: 'string',
      body: 'string',
      media: 'string',
      buttons: [{type: 'QUICK_REPLY', title: 'string', url: 'string', phone: 'string'}]
    }
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://api.channelautomation.com/api/rcs/workspaces/<workspaceId>/templates/validate"

payload = {
    "label": "string",
    "smsFallback": "string",
    "card": {
        "title": "string",
        "subtitle": "string",
        "body": "string",
        "media": "string",
        "buttons": [
            {
                "type": "QUICK_REPLY",
                "title": "string",
                "url": "string",
                "phone": "string"
            }
        ]
    }
}
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer <token>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
```

## Responses

### 200

{ok:true} if valid, {ok:false, error} otherwise.

### 401

Authentication required

#### Example

```json
{
  "error": "Authentication required",
  "success": false
}
```

- `error` (`post/api/rcs/workspaces/workspaceId/templates/validate.response.401.error`; string, optional)
  - example `"Authentication required"`
- `success` (`post/api/rcs/workspaces/workspaceId/templates/validate.response.401.success`; boolean, optional)
  - example `false`

### 403

Membership in the path workspace is required.

### 503

Identity or workspace access verification is temporarily unavailable.


Source: https://developer.channelautomations.com/api/post-api-rcs-workspaces-workspace-id-templates-validate/index.md