Free tool· Developer utilities
Build WhatsApp Cloud API requests you can run straight away
Choose a message type — text, template, image, document, video, audio, location or reply buttons — fill in the fields, and get a validated request as curl, Node.js, Python or raw JSON, with the endpoint, headers and a sample response.
- Runs in your browser
- Free, no signup
- Updated
Where it goes
WhatsApp Manager → Phone numbers → the number's ID (not the number).
Country code + number, digits only — 919876543210.
Quote an earlier message with its wamid.
Text message
Request
POST https://graph.facebook.com/v26.0/{PHONE_NUMBER_ID}/messages
curl -X POST 'https://graph.facebook.com/v26.0/{PHONE_NUMBER_ID}/messages' \
-H "Authorization: Bearer $WHATSAPP_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "919876543210",
"type": "text",
"text": {
"preview_url": true,
"body": "Hi Asha! Your order IQ-20931 has shipped. Track it here: https://example.com/t/IQ-20931"
}
}'What comes back
A 200 response returns the message ID. Delivery, read and failure updates arrive later on your webhook, keyed by that ID.
{
"messaging_product": "whatsapp",
"contacts": [
{
"input": "919876543210",
"wa_id": "919876543210"
}
],
"messages": [
{
"id": "wamid.HBgMOTE5ODc2NTQzMjEwFQIAERgSQzVGMEVDNzlEQjM2QjQ4RjA1AA=="
}
]
}Common errors: 131030 recipient not in the test allow-list, 131047 outside the 24-hour window (send a template), 132001 template name or language not found.
Token
Use a system-user access token in the WHATSAPP_TOKEN environment variable; temporary tokens from the API setup page expire after 24 hours.
About this tool
What is the Cloud API Request Builder?
The Cloud API Request Builder is a free tool that builds a send-message request for Meta's WhatsApp Cloud API. Choose text, template, image, document, video, audio, location or reply buttons, fill in the fields and copy a validated request as curl, Node.js, Python or raw JSON, with the endpoint and a sample response.
- Price
- Free
- Signup
- None
- Your data
- Stays in your browser
- Updated
What you get
- Eight message types including templates and reply buttons
- curl, Node.js, Python and raw JSON output
- Limits checked as you type
- Reply-to (context) support
- Access token read from an environment variable, never pasted
Developer utilities · no account, nothing uploaded
How it works · three steps, no signup
How to use the Cloud API Request Builder
Step 1: Pick the message type
Text and media inside the 24-hour window, templates to start a conversation, or reply buttons for quick answers.
Step 2: Fill in the details
Phone number ID, recipient and content. Limits — button counts, title lengths, language codes — are checked as you type.
Step 3: Copy and run
Copy the curl command, Node.js or Python code; set WHATSAPP_TOKEN in your environment and send.
FAQ
Cloud API Request Builder: questions and answers
What do I need to send my first Cloud API message?
A WhatsApp Business Account with a registered phone number, that number's phone number ID, and an access token — ideally a permanent system-user token rather than the 24-hour temporary one. In test mode the recipient must be on your allowed list; in production you can message anyone who has opted in.
When do I have to use a template?
To start a conversation, or to message someone more than 24 hours after their last message to you. Inside that 24-hour customer-service window you can send free-form text, media, location and interactive messages. Sending free-form outside it returns error 131047.
Why does the request fail with a 132001 error?
The template name or language code does not match an approved template on that WhatsApp Business Account. Names are lowercase with underscores and the language must be the exact code the template was approved in — en and en_US are different templates.
Is my access token safe in this tool?
The tool never asks for it. Every generated snippet reads the token from a WHATSAPP_TOKEN environment variable, so you can paste the code into a terminal or project without the token ever touching a web page.
Which Graph API version should I use?
Use the latest version you have tested against — the builder defaults to v26.0, the version used across InfiQ's documentation. The version is only the path segment after graph.facebook.com, and Meta keeps each version available for at least two years after release, so pin it in configuration and upgrade deliberately rather than per request.
Still have questions?
Book a demoMore free tools
Keep your stack sharp
Ready to do this at scale?
InfiQ puts broadcasts, chatbots, a shared inbox and the developer API behind one dashboard — on the official WhatsApp Business API. 7-day free trial, no card required.