---
title: "Create RCS Carousel Template"
method: POST
path: "/template/create"
tags: ["Template APIs"]
---

# Create RCS Carousel Template

`POST /template/create`

## Request

- Base URL: `https://soipapi.netcorecloud.com`
- URL: `https://soipapi.netcorecloud.com/template/create`
- Auth: HTTP bearer

Send template creation details in the JSON request body. Use this API to create text templates, single rich cards, or multi-card carousel templates.

## Headers

- `api_key` string, required
- `Content-Type` string, required
- `nc_bot_id` string

## Request body

- object
  - `action_type` string: Enter the message type you want to create.
  - `payload` object
    - `template_name` string, required: Enter a unique template name.
    - `rcs_type` string, required: Enter the RCS message type (text_message, rich_card, carousel).
    - `template_content` string, required: Enter the message content for text templates.
    - `suggestions` object[]: Add action buttons to the template.
      - `suggestionType` string: Enter the action type (reply, url_action, dialer_action, etc.).
      - `displayText` string: Enter the button label.
      - `postback` string: Enter the identifier for tracking button interactions.
      - `url` string: Enter the URL for URL-type actions.
      - `phoneNumber` string: Enter the phone number for dialer actions.
    - `card_width` unknown
    - `card_height` unknown
    - `save_type` unknown
    - `cards` unknown
    - `type` unknown
    - `template_id` unknown

## Response `200`

Template created successfully.

**With suggestions**
```
{
  "message": "Template created successfully",
  "payload": {
    "name": "text_message_demo",
    "type": "text_message",
    "botId": "OCHhY1alm8nJfSnj",
    "textMessageContent": "Time to go big or go home because it's India VS Australia FINALS!",
    "suggestions": [
      {
        "suggestionType": "reply",
        "postback": "click_to_win",
        "displayText": "Click to Win"
      },
      {
        "suggestionType": "url_action",
        "postback": "answer_and_win",
        "displayText": "Answer and Win",
        "url": "https://brandx.onelink.me/"
      },
      {
        "suggestionType": "dialer_action",
        "postback": "call_now_fast",
        "displayText": "Call Now Fast",
        "phoneNumber": "+919876543212"
      }
    ],
    "createdViaApi": true
  },
  "status": "Success"
}
```

**Without suggestions**
```
{
  "message": "Template created successfully",
  "payload": {
    "name": "text_message_demo",
    "type": "text_message",
    "botId": "OCHhY1alm8nJfSnj",
    "textMessageContent": "Time to go big or go home because it's India VS Australia FINALS!",
    "createdViaApi": true
  },
  "status": "Success"
}
```

## Other responses

- `400`: Template creation failed. **Template already exists** ``` { "error": "Template with same name is already present.", "message": "Template creation failed", "status": "Failure" } ``` **Missing field** ``` { "error": "missing required field: rcs_type", "message": "Template creation failed", "status": "Failure" } ``` **Name length validation** ``` { "error": "The length of 'template_name' cannot be more than 20 characters", "message": "Template creation failed", "status": "Failure" } ```

---

[API](https://skmtc.dev/netcorecloud/apis/rcs-api.md) - [All operations](https://skmtc.dev/netcorecloud/apis/rcs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/netcorecloud/apis/rcs-api/revisions/479db24ef963?raw)