Forms
Create and send interactive WhatsApp forms.
Build interactive forms (powered by WhatsApp Flows) and send them to customers. Create draft forms, publish them, send to individual customers or in bulk, and retrieve submitted responses.
Copy this section as context for your AI coding agent
curl -X GET 'https://api.chatverse.io/v1/whatsapp/forms' \
-H 'Authorization: Bearer YOUR_API_KEY'Response · 200
json
{
"success": true,
"data": [
{
"id": "0c9d5a1e-…",
"name": "Quote request",
"status": "PUBLISHED",
"response_count": 5
}
]
}curl -X POST 'https://api.chatverse.io/v1/whatsapp/forms' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"name": "Quote request",
"category": "LEAD_GENERATION",
"title": "Get a quote",
"fields": [
{
"name": "full_name",
"label": "Your name",
"type": "short_text",
"required": true
}
]
}'Response · 201
json
{
"success": true,
"data": {
"id": "0c9d5a1e-…",
"name": "Quote request",
"status": "DRAFT"
}
}curl -X PUT 'https://api.chatverse.io/v1/whatsapp/forms/{id}' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"name": "Quote request",
"category": "LEAD_GENERATION",
"title": "Get a free quote",
"fields": [
{
"name": "full_name",
"label": "Your name",
"type": "short_text",
"required": true
}
]
}'Response · 200
json
{
"success": true,
"data": {
"id": "0c9d5a1e-…",
"title": "Get a free quote"
}
}curl -X POST 'https://api.chatverse.io/v1/whatsapp/forms/{id}/publish' \
-H 'Authorization: Bearer YOUR_API_KEY'Response · 200
json
{
"success": true,
"data": {
"id": "0c9d5a1e-…",
"status": "PUBLISHED",
"meta_flow_id": "9876543210"
}
}curl -X POST 'https://api.chatverse.io/v1/whatsapp/forms/{id}/send' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"to": "919876543210",
"text": "Please fill in this short form",
"cta": "Open form"
}'Response · 200
json
{
"success": true,
"data": {
"message_id": "wamid.HBgMOTE5ODc2NTQzMjEwFQIAERgS"
}
}curl -X POST 'https://api.chatverse.io/v1/whatsapp/forms/{id}/send-bulk' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"to": [
"919876543210",
"919812345678"
],
"text": "Please fill in this short form",
"cta": "Open form"
}'Response · 200
json
{
"success": true,
"data": {
"sent": 1,
"failed": 1,
"results": [
{
"to": "919876543210",
"success": true,
"message_id": "wamid.HBgM…"
},
{
"to": "919812345678",
"success": false,
"error": "Meta did not send the form. The customer must have messaged you in the last 24 hours."
}
]
}
}curl -X GET 'https://api.chatverse.io/v1/whatsapp/forms/{id}/responses' \
-H 'Authorization: Bearer YOUR_API_KEY'Response · 200
json
{
"success": true,
"data": [
{
"id": "e2f4a6b8-…",
"contact_number": "919876543210",
"contact_name": "Asha",
"answers": [
{
"name": "full_name",
"label": "Your name",
"value": "Asha Rao"
}
],
"created_at": "2026-10-26T08:30:00+00:00"
}
]
}