---
title: "Create an RCS card from the builder (Tier 3"
description: "Builds a Twilio Content Template (twilio/card + twilio/text fallback) from a builder payload and registers it in rcs_content_templates so it appears in the composer picker. Uses the workspace's own Twilio credentials. Enforces RCS card limits (title ≤200, subtitle ≤60, body ≤1600, ≤4 buttons). 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/create`

Builds a Twilio Content Template (twilio/card + twilio/text fallback) from a builder payload and registers it in rcs_content_templates so it appears in the composer picker. Uses the workspace's own Twilio credentials. Enforces RCS card limits (title ≤200, subtitle ≤60, body ≤1600, ≤4 buttons). Authenticated workspace user (Bearer).

## Authentication

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

## Path parameters

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

## Request body

_Required._

- `label` (`post/api/rcs/workspaces/workspaceId/templates/create.label`; string, required) — Internal card name (shown in the picker)
- `card` (`post/api/rcs/workspaces/workspaceId/templates/create.card`; object, required)
  - `title` (`post/api/rcs/workspaces/workspaceId/templates/create.card.title`; string, optional)
  - `subtitle` (`post/api/rcs/workspaces/workspaceId/templates/create.card.subtitle`; string, optional)
  - `body` (`post/api/rcs/workspaces/workspaceId/templates/create.card.body`; string, optional)
  - `media` (`post/api/rcs/workspaces/workspaceId/templates/create.card.media`; string, optional) — Public image URL
  - `buttons` (`post/api/rcs/workspaces/workspaceId/templates/create.card.buttons`; array<object>, optional)
    - `type` (`post/api/rcs/workspaces/workspaceId/templates/create.card.buttons.type`; string, optional)
      - one of `"QUICK_REPLY"`, `"URL"`, `"PHONE_NUMBER"`
    - `title` (`post/api/rcs/workspaces/workspaceId/templates/create.card.buttons.title`; string, optional)
    - `url` (`post/api/rcs/workspaces/workspaceId/templates/create.card.buttons.url`; string, optional)
    - `phone` (`post/api/rcs/workspaces/workspaceId/templates/create.card.buttons.phone`; string, optional)
- `description` (`post/api/rcs/workspaces/workspaceId/templates/create.description`; string, optional)
- `smsFallback` (`post/api/rcs/workspaces/workspaceId/templates/create.smsFallback`; string, optional) — Text sent to non-RCS devices
- `variableMapping` (`post/api/rcs/workspaces/workspaceId/templates/create.variableMapping`; object, optional) — e.g. {"1":"contact.firstname"} — maps {{n}} to contact/appointment fields

## Example request

```json
{
  "label": "string",
  "description": "string",
  "smsFallback": "string",
  "variableMapping": {},
  "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/create' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "label": "string",
  "description": "string",
  "smsFallback": "string",
  "variableMapping": {},
  "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/create';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json', Authorization: 'Bearer <token>'},
  body: JSON.stringify({
    label: 'string',
    description: 'string',
    smsFallback: 'string',
    variableMapping: {},
    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/create"

payload = {
    "label": "string",
    "description": "string",
    "smsFallback": "string",
    "variableMapping": {},
    "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

Card created + registered.

### 400

Validation error or Twilio Content API error.

### 401

Authentication required

#### Example

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

- `error` (`post/api/rcs/workspaces/workspaceId/templates/create.response.401.error`; string, optional)
  - example `"Authentication required"`
- `success` (`post/api/rcs/workspaces/workspaceId/templates/create.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-create/index.md