---
title: "Send a WhatsApp form to one person"
method: POST
path: "/api/v1/tools/send_whatsapp_form"
---

# Send a WhatsApp form to one person

`POST /api/v1/tools/send_whatsapp_form`

## Request

- Base URL: `https://whatsync.app`
- URL: `https://whatsync.app/api/v1/tools/send_whatsapp_form`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

SENDS a real WhatsApp message with a button that opens a form, from the official Business number to exactly one person. Use only when the user asks to send this form to this person. The person must have messaged the Business number in the last 24 hours. A DRAFT form is sent in test mode with a banner; use that only to test with the user's own phone or team. Read the answers later with list_form_responses. Never use for bulk sends or automatic retries; acceptance is not delivery.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `idempotencyKey` string, required: Unique key for this intended action. Reuse exactly on retries; use a new key only for a new action.
  - `form_id` string, required
  - `conversationId` string: The exact conversation_id from another WhatSync tool
  - `phoneNumber` string: One recipient's phone number with country code
  - `body` string, required: Message text shown above the button
  - `buttonText` string, required: Button label that opens the form, no emoji
  - `header` string
  - `footer` string

## Response `200`

JSON result. Every response includes X-Request-Id.

- object

## Other responses

- `400`: API error
- `401`: API error
- `403`: API error
- `404`: API error
- `409`: API error
- `413`: API error
- `415`: API error
- `422`: API error
- `429`: API error
- `503`: API error

---

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