Vaaniq
Integrations & API

How to Send WhatsApp Messages Using the API

Trigger an approved WhatsApp template from your own website, CRM, or automation tool with a single API call.

Advanced 5 min read

Tutorial video coming soon

What You'll Learn

In this tutorial you'll learn:

  • Call the send-template API endpoint
  • Understand the request and response shape

Prerequisites

Before you start:

  • An API key with the template:send scope
  • An approved WhatsApp template

Step-by-Step Guide

1

Prepare the request

POST to /api/v1/send/template with an X-API-Key header, and a JSON body containing the recipient's phone number, the template name, its language code, and any variable values it needs.

Authenticating requests panel with an example POST /api/v1/send/template request using the X-API-Key header
The Developer page shows an example request.
2

Send it

The message is billed at the template's real category rate and sent through your connected WhatsApp number.

3

Read the response

A successful call returns the internal message ID, WhatsApp's own message ID, its initial status, and the credits it cost.

4

Make retries safe

Pass an idempotency_key with each request so a retry from your own system's side never sends the same message twice.

Tip

This same approach is how you'd wire Vaaniq into a no-code tool like Zapier, Make, or n8n — configure a Custom HTTP Action pointed at this same endpoint. There's no dedicated Vaaniq app in any of those tools today, so this generic HTTP call is the way to connect them.

Integrations & API

How to Receive WhatsApp Events Using Webhooks

Register your own endpoint to receive real-time, signed events whenever a message is sent, delivered, read, or a campaign finishes.

Advanced 5 min read
Read Tutorial
Integrations & API

How to Create an API Key

Generate a scoped API key to authenticate requests from your own systems into Vaaniq's Messaging API.

Intermediate 3 min read
Read Tutorial
Automation & Chatbots

How to Connect APIs with Chatbot Flows

Call an external API from inside a chatbot flow and use its response to drive the conversation.

Advanced 6 min read
Read Tutorial
Getting Started

Your First WhatsApp Message with Vaaniq

Send a real, working WhatsApp message from Vaaniq for the first time — the fastest path from a fresh account to a delivered message.

Beginner 3 min read
Read Tutorial
How to Send WhatsApp Messages Using the API — Vaaniq Tutorials