---
title: "Send WhatsApp Template Message"
method: POST
path: "/user/whatsapp/send"
tags: ["WhatsApp"]
---

# Send WhatsApp Template Message

`POST /user/whatsapp/send`

## Request

- Base URL: `https://app.famulor.de/api`
- URL: `https://app.famulor.de/api/user/whatsapp/send`
- Auth: HTTP bearer

Send a WhatsApp message using an approved template via Famulor

[Docs](https://docs.famulor.io/api-v1/whatsapp/send-template)

## Request body

- object
  - `sender_id` integer, required: The ID of the WhatsApp sender to send from (obtained from the [Get Senders](/en/api-reference/whatsapp/get-senders) endpoint)
  - `template_id` integer, required: The ID of the message template to use (obtained from the [Get Templates](/en/api-reference/whatsapp/get-templates) endpoint)
  - `recipient_phone` string, required: The recipient's phone number in international format (e.g., `+1234567890`)
  - `recipient_name` string: The recipient's name, max 255 characters (used for conversation tracking and CRM purposes)
  - `variables` object: Key-value pairs for template variables. Keys should match the variable names from the template. If the template has variables `{{1}}`, `{{2}}`, etc., provide them as `{"1": "value1", "2": "value2"}` or using the named keys from the template's `variables` array.
    - `1` string: Value for the first template variable
    - `2` string: Value for the second template variable

## Response `200`

Success

- object
  - `success` boolean: Whether the message was sent successfully
  - `conversation_id` integer: The ID of the conversation (new or existing) associated with this message
  - `message_id` integer: The ID of the conversation message record
  - `whatsapp_message_id` integer: The ID of the WhatsApp message record
  - `message_sid` string: The Twilio message SID for tracking delivery
  - `status` string: The initial message delivery status (e.g., `queued`, `sent`)
  - `402 Insufficient Balance` string
  - `404 Not Found` string
  - `422 Unprocessable Entity` string

## Other responses

- `401`: Fehlender oder ungültiger API-Key.
- `402`: Insufficient Balance
- `404`: Not Found
- `422`: Unprocessable Entity

---

[API](https://skmtc.dev/famulor/apis/famulor-api.md) · [All operations](https://skmtc.dev/famulor/apis/famulor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/famulor/apis/famulor-api/revisions/3b938c370721?raw)