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

# Send WhatsApp Freeform Message

`POST /user/whatsapp/send-freeform`

## Request

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

Send a free-text WhatsApp message within an active 24-hour session via Famulor

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

## 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)
  - `recipient_phone` string, required: The recipient's phone number in international format (e.g., `+1234567890`)
  - `message` string, required: The message content to send (max 4096 characters)

## Response `200`

Success

- object
  - `success` boolean: Whether the message was sent successfully
  - `conversation_id` integer: The ID of the conversation 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
  - `session_status` object: Updated session status after sending the message
    - `is_open` boolean: Whether the 24-hour messaging window is currently open
    - `can_send_freeform` boolean: Whether freeform messages can be sent right now
    - `requires_template` boolean: Whether a template message is required
    - `message` string: Human-readable description of the session state
    - `minutes_remaining` integer: Minutes remaining in the 24-hour window
    - `expires_at` string: ISO 8601 timestamp when the session expires
  - `402 Insufficient Balance` string
  - `403 Session Expired` string
  - `404 Not Found` string
  - `503 Sender Offline` string

## Other responses

- `401`: Fehlender oder ungültiger API-Key.
- `402`: Insufficient Balance
- `403`: Session Expired
- `404`: Sender Not Found
- `422`: Invalid Phone
- `503`: Sender Offline

---

[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)