infoOverview
About this API
keySecurity
Authentication
This endpoint does not require authentication.
uploadInput
Request Body
Send a application/json payload. Replace placeholder values with data from your integration.
Top-Level Fields
NameTypeRequirementDescription
botIdstringNot specifiedRequest value for botId.templateNamestringNot specifiedRequest value for templateName.templateTypestringNot specifiedRequest value for templateType.botMessageTypestringNot specifiedRequest value for botMessageType.textMessageDetailsobjectNot specifiedRequest value for textMessageDetails.isSMSFallbackRequiredbooleanNot specifiedRequest value for isSMSFallbackRequired.{
"botId": "68218acedb298103bc8d5931",
"templateName": "99",
"templateType": "text_message",
"botMessageType": "PROMOTIONAL",
"textMessageDetails": {
"messageContent": "Hello [username], welcome onboard!",
"suggestionsList": [
{
"typeOfAction": "reply",
"suggestionText": "know more",
"suggestionPostback": "know more"
}
]
},
"isSMSFallbackRequired": false
}{
"type": "object",
"properties": {
"botId": {
"type": "string"
},
"templateName": {
"type": "string"
},
"templateType": {
"type": "string"
},
"botMessageType": {
"type": "string"
},
"textMessageDetails": {
"type": "object",
"properties": {
"messageContent": {
"type": "string"
},
"suggestionsList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"typeOfAction": {
"type": "string"
},
"suggestionText": {
"type": "string"
},
"suggestionPostback": {
"type": "string"
}
}
}
}
}
},
"isSMSFallbackRequired": {
"type": "boolean"
}
}
}codeIntegration
Code Examples
Select your language and customize the request URL. Credential placeholders are intentionally preserved so secrets never appear in generated samples.
shield_lockCredentials protectedAdd secrets only in your secure server environment.
curl --request POST 'https://api.example.com/rcs/api/v1/create-template' \
--header 'Content-Type: application/json' \
--data '{
"botId": "68218acedb298103bc8d5931",
"templateName": "99",
"templateType": "text_message",
"botMessageType": "PROMOTIONAL",
"textMessageDetails": {
"messageContent": "Hello [username], welcome onboard!",
"suggestionsList": [
{
"typeOfAction": "reply",
"suggestionText": "know more",
"suggestionPostback": "know more"
}
]
},
"isSMSFallbackRequired": false
}'const response = await fetch('https://api.example.com/rcs/api/v1/create-template', {
method: 'POST',
headers: {
"Content-Type": "application/json"
},
body: JSON.stringify({
"botId": "68218acedb298103bc8d5931",
"templateName": "99",
"templateType": "text_message",
"botMessageType": "PROMOTIONAL",
"textMessageDetails": {
"messageContent": "Hello [username], welcome onboard!",
"suggestionsList": [
{
"typeOfAction": "reply",
"suggestionText": "know more",
"suggestionPostback": "know more"
}
]
},
"isSMSFallbackRequired": false
})
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
console.log(data);const response = await fetch('https://api.example.com/rcs/api/v1/create-template', {
method: 'POST',
headers: {
"Content-Type": "application/json"
},
body: JSON.stringify({
"botId": "68218acedb298103bc8d5931",
"templateName": "99",
"templateType": "text_message",
"botMessageType": "PROMOTIONAL",
"textMessageDetails": {
"messageContent": "Hello [username], welcome onboard!",
"suggestionsList": [
{
"typeOfAction": "reply",
"suggestionText": "know more",
"suggestionPostback": "know more"
}
]
},
"isSMSFallbackRequired": false
})
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
console.log(data);import json
import requests
url = 'https://api.example.com/rcs/api/v1/create-template'
headers = {
"Content-Type": "application/json"
}
payload = json.loads(r'''{
"botId": "68218acedb298103bc8d5931",
"templateName": "99",
"templateType": "text_message",
"botMessageType": "PROMOTIONAL",
"textMessageDetails": {
"messageContent": "Hello [username], welcome onboard!",
"suggestionsList": [
{
"typeOfAction": "reply",
"suggestionText": "know more",
"suggestionPostback": "know more"
}
]
},
"isSMSFallbackRequired": false
}''')
response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
print(response.json())import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
var client = HttpClient.newHttpClient();
String body = """
{
"botId": "68218acedb298103bc8d5931",
"templateName": "99",
"templateType": "text_message",
"botMessageType": "PROMOTIONAL",
"textMessageDetails": {
"messageContent": "Hello [username], welcome onboard!",
"suggestionsList": [
{
"typeOfAction": "reply",
"suggestionText": "know more",
"suggestionPostback": "know more"
}
]
},
"isSMSFallbackRequired": false
}
""";
var request = HttpRequest.newBuilder(URI.create("https://api.example.com/rcs/api/v1/create-template"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString(body))
.build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());<?php
$curl = curl_init();
$payload = '{
"botId": "68218acedb298103bc8d5931",
"templateName": "99",
"templateType": "text_message",
"botMessageType": "PROMOTIONAL",
"textMessageDetails": {
"messageContent": "Hello [username], welcome onboard!",
"suggestionsList": [
{
"typeOfAction": "reply",
"suggestionText": "know more",
"suggestionPostback": "know more"
}
]
},
"isSMSFallbackRequired": false
}';
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.example.com/rcs/api/v1/create-template',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ["Content-Type: application/json"],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($curl);
if ($response === false) throw new Exception(curl_error($curl));
curl_close($curl);
echo $response;using System.Net.Http.Headers;
using System.Text;
using var client = new HttpClient();
var json = """
{
"botId": "68218acedb298103bc8d5931",
"templateName": "99",
"templateType": "text_message",
"botMessageType": "PROMOTIONAL",
"textMessageDetails": {
"messageContent": "Hello [username], welcome onboard!",
"suggestionsList": [
{
"typeOfAction": "reply",
"suggestionText": "know more",
"suggestionPostback": "know more"
}
]
},
"isSMSFallbackRequired": false
}
""";
using var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://api.example.com/rcs/api/v1/create-template", content);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
"bytes"
)
func main() {
request, err := http.NewRequest("POST", "https://api.example.com/rcs/api/v1/create-template", bytes.NewBufferString("{\n \"botId\": \"68218acedb298103bc8d5931\",\n \"templateName\": \"99\",\n \"templateType\": \"text_message\",\n \"botMessageType\": \"PROMOTIONAL\",\n \"textMessageDetails\": {\n \"messageContent\": \"Hello [username], welcome onboard!\",\n \"suggestionsList\": [\n {\n \"typeOfAction\": \"reply\",\n \"suggestionText\": \"know more\",\n \"suggestionPostback\": \"know more\"\n }\n ]\n },\n \"isSMSFallbackRequired\": false\n}"))
if err != nil { panic(err) }
request.Header.Set("Content-Type", "application/json")
request.Header.Set("Accept", "application/json")
response, err := http.DefaultClient.Do(request)
if err != nil { panic(err) }
defer response.Body.Close()
data, err := io.ReadAll(response.Body)
if err != nil { panic(err) }
if response.StatusCode >= 400 { panic(fmt.Sprintf("HTTP %d: %s", response.StatusCode, data)) }
fmt.Println(string(data))
}downloadOutput
Response
A successful request returns the documented response payload. Delivery and asynchronous events may arrive separately through configured webhooks.
{
"409": {
"code": 409,
"status": "ERROR",
"message": "Template name already exist"
}
}{}ruleHTTP Responses
Status Codes
409Conflict