# create-template - STANDALONE **POST** `/api/v1/create-template` Product: [RCS](https://devdocs.1spoc.com/docs/rcs.md) Version: [1.0](https://devdocs.1spoc.com/docs/rcs/1-0.md) Category: **TEMPLATES** Lifecycle: **active** ## Request overview Full URL: `https://api.example.com/rcs/api/v1/create-template` Method: `POST` Content type: `application/json` ## Authentication This endpoint does not require authentication. ## Parameters ### Path parameters None. ### Query parameters None. ### Request body fields None. ## Request schema ```json { "type": "string" } ``` ## Request example ```json { "raw_example": "{\n \"templateName\": \"18_pdf\",\n \"templateType\": \"rich_card\",\n \"botId\": \"{{nhea_botId}}\",\n \"botMessageType\": \"PROMOTIONAL\",\n \"isSMSFallbackRequired\": false,\n \"richCardStandAloneDetails\": {\n \"mediaType\":\"pdf\",\n \"cardOrientation\": \"HORIZONTAL\",\n \"cardAlignment\": \"RIGHT\", \n \"mediaHeight\": \"MEDIUM_HEIGHT\",\n \"cardTitle\": \"Happy Ganesh Chaturthi!\",\n \"cardDescription\": \"Ganesh Chaturthi!\",\n \"media\": {\n \"url\": \"https://rcs-bot-media-public.s3.ap-south-1.amazonaws.com/665873c0c660399dce731130/65c4eabecf32f14a18535f10/68e62ccce08a66956ff75a77/richCardStandAloneDetails_1759915212564_9mb.pdf\"\n },\n // \"thumbnail\": {\n // \"url\": \"\"\n // },\n \"suggestionsList\": []\n }\n}" } ``` ## Response schema ```json {} ``` ## Response examples ```json {} ``` ## Status codes ```json [ { "code": 200, "description": "Successful response" } ] ``` ## Generated integration examples The following examples are generated from the published **POST /api/v1/create-template** contract and use placeholder credentials. ### cURL ```curl curl --request POST 'https://api.example.com/rcs/api/v1/create-template' \ --header 'Content-Type: application/json' \ --data '{ "raw_example": "{\n \"templateName\": \"18_pdf\",\n \"templateType\": \"rich_card\",\n \"botId\": \"{{nhea_botId}}\",\n \"botMessageType\": \"PROMOTIONAL\",\n \"isSMSFallbackRequired\": false,\n \"richCardStandAloneDetails\": {\n \"mediaType\":\"pdf\",\n \"cardOrientation\": \"HORIZONTAL\",\n \"cardAlignment\": \"RIGHT\", \n \"mediaHeight\": \"MEDIUM_HEIGHT\",\n \"cardTitle\": \"Happy Ganesh Chaturthi!\",\n \"cardDescription\": \"Ganesh Chaturthi!\",\n \"media\": {\n \"url\": \"https://rcs-bot-media-public.s3.ap-south-1.amazonaws.com/665873c0c660399dce731130/65c4eabecf32f14a18535f10/68e62ccce08a66956ff75a77/richCardStandAloneDetails_1759915212564_9mb.pdf\"\n },\n // \"thumbnail\": {\n // \"url\": \"\"\n // },\n \"suggestionsList\": []\n }\n}" }' ``` ### JavaScript ```javascript const response = await fetch('https://api.example.com/rcs/api/v1/create-template', { method: 'POST', headers: { "Content-Type": "application/json" }, body: JSON.stringify({ "raw_example": "{\n \"templateName\": \"18_pdf\",\n \"templateType\": \"rich_card\",\n \"botId\": \"{{nhea_botId}}\",\n \"botMessageType\": \"PROMOTIONAL\",\n \"isSMSFallbackRequired\": false,\n \"richCardStandAloneDetails\": {\n \"mediaType\":\"pdf\",\n \"cardOrientation\": \"HORIZONTAL\",\n \"cardAlignment\": \"RIGHT\", \n \"mediaHeight\": \"MEDIUM_HEIGHT\",\n \"cardTitle\": \"Happy Ganesh Chaturthi!\",\n \"cardDescription\": \"Ganesh Chaturthi!\",\n \"media\": {\n \"url\": \"https://rcs-bot-media-public.s3.ap-south-1.amazonaws.com/665873c0c660399dce731130/65c4eabecf32f14a18535f10/68e62ccce08a66956ff75a77/richCardStandAloneDetails_1759915212564_9mb.pdf\"\n },\n // \"thumbnail\": {\n // \"url\": \"\"\n // },\n \"suggestionsList\": []\n }\n}" }) }); if (!response.ok) throw new Error(`HTTP ${response.status}`); const data = await response.json(); console.log(data); ``` ### NodeJS ```node const response = await fetch('https://api.example.com/rcs/api/v1/create-template', { method: 'POST', headers: { "Content-Type": "application/json" }, body: JSON.stringify({ "raw_example": "{\n \"templateName\": \"18_pdf\",\n \"templateType\": \"rich_card\",\n \"botId\": \"{{nhea_botId}}\",\n \"botMessageType\": \"PROMOTIONAL\",\n \"isSMSFallbackRequired\": false,\n \"richCardStandAloneDetails\": {\n \"mediaType\":\"pdf\",\n \"cardOrientation\": \"HORIZONTAL\",\n \"cardAlignment\": \"RIGHT\", \n \"mediaHeight\": \"MEDIUM_HEIGHT\",\n \"cardTitle\": \"Happy Ganesh Chaturthi!\",\n \"cardDescription\": \"Ganesh Chaturthi!\",\n \"media\": {\n \"url\": \"https://rcs-bot-media-public.s3.ap-south-1.amazonaws.com/665873c0c660399dce731130/65c4eabecf32f14a18535f10/68e62ccce08a66956ff75a77/richCardStandAloneDetails_1759915212564_9mb.pdf\"\n },\n // \"thumbnail\": {\n // \"url\": \"\"\n // },\n \"suggestionsList\": []\n }\n}" }) }); if (!response.ok) throw new Error(`HTTP ${response.status}`); const data = await response.json(); console.log(data); ``` ### Python ```python import json import requests url = 'https://api.example.com/rcs/api/v1/create-template' headers = { "Content-Type": "application/json" } payload = json.loads(r'''{ "raw_example": "{\\n \\"templateName\\": \\"18_pdf\\",\\n \\"templateType\\": \\"rich_card\\",\\n \\"botId\\": \\"{{nhea_botId}}\\",\\n \\"botMessageType\\": \\"PROMOTIONAL\\",\\n \\"isSMSFallbackRequired\\": false,\\n \\"richCardStandAloneDetails\\": {\\n \\"mediaType\\":\\"pdf\\",\\n \\"cardOrientation\\": \\"HORIZONTAL\\",\\n \\"cardAlignment\\": \\"RIGHT\\", \\n \\"mediaHeight\\": \\"MEDIUM_HEIGHT\\",\\n \\"cardTitle\\": \\"Happy Ganesh Chaturthi!\\",\\n \\"cardDescription\\": \\"Ganesh Chaturthi!\\",\\n \\"media\\": {\\n \\"url\\": \\"https://rcs-bot-media-public.s3.ap-south-1.amazonaws.com/665873c0c660399dce731130/65c4eabecf32f14a18535f10/68e62ccce08a66956ff75a77/richCardStandAloneDetails_1759915212564_9mb.pdf\\"\\n },\\n // \\"thumbnail\\": {\\n // \\"url\\": \\"\\"\\n // },\\n \\"suggestionsList\\": []\\n }\\n}" }''') response = requests.post(url, headers=headers, json=payload) response.raise_for_status() print(response.json()) ``` ### Java ```java 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 = """ { "raw_example": "{\n \"templateName\": \"18_pdf\",\n \"templateType\": \"rich_card\",\n \"botId\": \"{{nhea_botId}}\",\n \"botMessageType\": \"PROMOTIONAL\",\n \"isSMSFallbackRequired\": false,\n \"richCardStandAloneDetails\": {\n \"mediaType\":\"pdf\",\n \"cardOrientation\": \"HORIZONTAL\",\n \"cardAlignment\": \"RIGHT\", \n \"mediaHeight\": \"MEDIUM_HEIGHT\",\n \"cardTitle\": \"Happy Ganesh Chaturthi!\",\n \"cardDescription\": \"Ganesh Chaturthi!\",\n \"media\": {\n \"url\": \"https://rcs-bot-media-public.s3.ap-south-1.amazonaws.com/665873c0c660399dce731130/65c4eabecf32f14a18535f10/68e62ccce08a66956ff75a77/richCardStandAloneDetails_1759915212564_9mb.pdf\"\n },\n // \"thumbnail\": {\n // \"url\": \"\"\n // },\n \"suggestionsList\": []\n }\n}" } """; 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 ```php '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; ``` ### C# ```csharp using System.Net.Http.Headers; using System.Text; using var client = new HttpClient(); var json = """ { "raw_example": "{\n \"templateName\": \"18_pdf\",\n \"templateType\": \"rich_card\",\n \"botId\": \"{{nhea_botId}}\",\n \"botMessageType\": \"PROMOTIONAL\",\n \"isSMSFallbackRequired\": false,\n \"richCardStandAloneDetails\": {\n \"mediaType\":\"pdf\",\n \"cardOrientation\": \"HORIZONTAL\",\n \"cardAlignment\": \"RIGHT\", \n \"mediaHeight\": \"MEDIUM_HEIGHT\",\n \"cardTitle\": \"Happy Ganesh Chaturthi!\",\n \"cardDescription\": \"Ganesh Chaturthi!\",\n \"media\": {\n \"url\": \"https://rcs-bot-media-public.s3.ap-south-1.amazonaws.com/665873c0c660399dce731130/65c4eabecf32f14a18535f10/68e62ccce08a66956ff75a77/richCardStandAloneDetails_1759915212564_9mb.pdf\"\n },\n // \"thumbnail\": {\n // \"url\": \"\"\n // },\n \"suggestionsList\": []\n }\n}" } """; 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()); ``` ### Go ```go 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 \"raw_example\": \"{\\n \\\"templateName\\\": \\\"18_pdf\\\",\\n \\\"templateType\\\": \\\"rich_card\\\",\\n \\\"botId\\\": \\\"{{nhea_botId}}\\\",\\n \\\"botMessageType\\\": \\\"PROMOTIONAL\\\",\\n \\\"isSMSFallbackRequired\\\": false,\\n \\\"richCardStandAloneDetails\\\": {\\n \\\"mediaType\\\":\\\"pdf\\\",\\n \\\"cardOrientation\\\": \\\"HORIZONTAL\\\",\\n \\\"cardAlignment\\\": \\\"RIGHT\\\", \\n \\\"mediaHeight\\\": \\\"MEDIUM_HEIGHT\\\",\\n \\\"cardTitle\\\": \\\"Happy Ganesh Chaturthi!\\\",\\n \\\"cardDescription\\\": \\\"Ganesh Chaturthi!\\\",\\n \\\"media\\\": {\\n \\\"url\\\": \\\"https://rcs-bot-media-public.s3.ap-south-1.amazonaws.com/665873c0c660399dce731130/65c4eabecf32f14a18535f10/68e62ccce08a66956ff75a77/richCardStandAloneDetails_1759915212564_9mb.pdf\\\"\\n },\\n // \\\"thumbnail\\\": {\\n // \\\"url\\\": \\\"\\\"\\n // },\\n \\\"suggestionsList\\\": []\\n }\\n}\"\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)) } ``` ## Related resources - [Interactive documentation page](https://devdocs.1spoc.com/docs/rcs/1-0/create-template-standalone) - [Version documentation](https://devdocs.1spoc.com/docs/rcs/1-0.md) - [OpenAPI JSON](https://devdocs.1spoc.com/docs/rcs/1-0/openapi.json) - [OpenAPI YAML](https://devdocs.1spoc.com/docs/rcs/1-0/openapi.yaml) - [Postman collection](https://devdocs.1spoc.com/postman/rcs/1-0/collection.json) - [Postman environment](https://devdocs.1spoc.com/postman/rcs/1-0/environment.json) - [MCP setup](https://devdocs.1spoc.com/mcp-setup) - [AI documentation index](https://devdocs.1spoc.com/llms.txt) - [Complete AI documentation](https://devdocs.1spoc.com/llms-full.txt) - [Node.js SDK](https://devdocs.1spoc.com/sdk/rcs/1-0/node.zip) - [Python SDK](https://devdocs.1spoc.com/sdk/rcs/1-0/python.zip) - [Java SDK](https://devdocs.1spoc.com/sdk/rcs/1-0/java.zip) ## Guidance for AI assistants Treat this document and its linked OpenAPI contract as the source of truth for **POST /api/v1/create-template**. - Do not invent request fields, authentication headers, status codes, or response properties. - Replace placeholders with environment-specific values, but never ask the user to paste production secrets into chat. - Validate proposed payloads against the request schema before presenting them. - Explain which values are required and identify assumptions clearly. - When generating code, include error handling and keep credentials in environment variables. - Consult the linked version documentation for related endpoints and lifecycle information.