---
title: "Send template messages"
method: POST
path: "/api/ext/v3/messageTemplates/send"
tags: ["MessageTemplate"]
---

# Send template messages

`POST /api/ext/v3/messageTemplates/send`

## Request body

- SendTemplateMessagesRequest — Request model for sending template messages.
  - `channel` string, nullable — The channel name or number from which the template messages will be sent (null for default channel).
  - `template_name` string, required — The name of the template to be used for sending messages.
  - `broadcast_name` string, required — The name of the broadcast to be created.
  - `recipients` TemplateMessageRecipientDto[], required — List of recipients to send the template message to. (1 to 10,000 items)
    - `phone_number` string, nullable, required — The recipient's phone number.
    - `local_message_id` string, nullable — The local message identifier.
    - `custom_params` TemplateParameterDto[], nullable — A list of custom parameters to be used in the template message.
      - `name` string, nullable — The name of the template parameter.
      - `value` string, nullable — The value of the template parameter.

## Response `200`

Returns the send result.

- SendTemplateMessagesResponse — Represents the result of sending template messages to recipients.
  - `success` boolean — Indicates whether the operation was successful.
  - `broadcast_id` string, nullable — The ID of the created broadcast.
  - `error` string, nullable — An error message, if any.
  - `recipients` TemplateMessageRecipientResultDto[], nullable — A list of results for each recipient.
    - `local_message_id` string, nullable — The local message identifier.
    - `phone_number` string, nullable — The recipient's phone number.
    - `errors` string[], nullable — A list of errors encountered while sending the message, if any.

## Other responses

- `400` — The request is invalid.
- `401` — The request is unauthorized.
- `403` — The request is forbidden.
- `429` — Too many requests. Either the rate limit has been exceeded or usage limits have been reached.
- `500` — Unexpected error occurred. Please try again.

---

[API](https://skmtc.dev/wati/apis/api-documentation-v3.md) · [All operations](https://skmtc.dev/wati/apis/api-documentation-v3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wati/api-documentation-v3/revisions/dee16d2c7d41/schema)