> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeplo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# POST Send Template Message (v1)

> Send a WhatsApp template message via the external API.

## Send template message (v1)

`POST /api/v1/messages/template`

Send a WhatsApp template message using an approved template.

### Headers

**x-api-key** `string` *required*

Your API key

**x-api-secret** `string` *required*

Your API secret key

**x-channel-id** `string` *required*

WhatsApp channel ID

### Body parameters

**to** `string` *required*

Recipient phone with country code.

**templateName** `string` *required*

Approved template name.

**languageCode** `string` (default: en)

Template language.

**components** `array`

Template component parameters.

### Hello World

```bash cURL theme={null}
curl -X POST https://zeplo.ai/api/v1/messages/template \
  -H "x-api-key: zeplo_ak_abc123..." \
  -H "x-api-secret: zeplo_as_abc123..." \
  -H "x-channel-id: 647015955153740" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "templateName": "hello_world",
    "languageCode": "en"
  }'
```

### With parameters

```bash cURL theme={null}
curl -X POST https://zeplo.ai/api/v1/messages/template \
  -H "x-api-key: zeplo_ak_abc123..." \
  -H "x-api-secret: zeplo_as_abc123..." \
  -H "x-channel-id: 647015955153740" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "templateName": "order_confirmation",
    "languageCode": "en",
    "components": [
      {
        "type": "body",
        "parameters": [
          { "type": "text", "text": "John" },
          { "type": "text", "text": "ORD-12345" }
        ]
      }
    ]
  }'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.