Sinch Api Templates Create

---
name: sinch-api-templates-create
description: Create a new message template via Sinch Template Management API (V2)
---

# Create Message Template

Create a new omni-channel message template with the Sinch Template Management API V2. Supports text, variables (${key}), and multiple language translations.

**IMPORTANT: Execute this command directly. Do NOT generate script files. Perform the API call immediately.**

## Input

- `--description` / `-d`: Template description - optional
- `--default-language` / `-l`: Default language code (e.g. en-US) - required
- `--text` / `-t`: Template text with optional ${variable} placeholders - required
- `--variables` / `-v`: Comma-separated variable names or JSON with key/preview_value - optional

Arguments: $ARGUMENTS

## Instructions

**Execute these steps directly - do not write code or scripts:**

0. If $ARGUMENTS empty: ask for description, default language, template text, and variable names (if any). Otherwise parse.

1. Validate: --default-language (e.g. en-US), --text (non-empty). Parse --variables into array of {key, preview_value}. Build translations array with one item: language_code, variables, text_message.text.

2. Get CONVERSATION_* env vars. Template API: https://{region}.template.api.sinch.com. If missing, report "Sinch API is not configured."

3. Request body: description, default_translation (default language), translations: [{ language_code, variables: [{key, preview_value}], text_message: { text } }].

4. POST https://{region}.template.api.sinch.com/v2/projects/{projectId}/templates with OAuth2 and JSON body.

5. On success: "✅ Template created" with template id and version. Handle 400 (validation), 401 with clear messages.

6. Handle all errors gracefully.

## Examples

```
/sinch-api-templates-create --default-language=en-US --text="Hello ${name}, your order ${order_id} is ready."
/sinch-api-templates-create -l en-US -t "Hi ${customer_name}!" -v name,customer_name -d "Welcome template"
```

## API Reference

- **Endpoint**: POST /v2/projects/{project_id}/templates
- **Documentation**: https://developers.sinch.com/docs/conversation/templates/