Technical GuideStep-by-Step⏱ 15 min read

Test WhatsApp API with Postman — Step-by-Step Collection Guide

Before writing a single line of production code, test every WhatsApp API endpoint in Postman. This guide walks you through importing the WA.Expert Postman collection, configuring environment variables, sending your first WhatsApp message, testing template messages, and debugging responses — all before touching your codebase.

Get WA.Expert API Key → Talk to a Developer

Overview

What this guide covers

Postman is the fastest way to validate your WA.Expert API credentials, test template variables, and understand response formats. Most integration bugs are caught in Postman before they ever hit production code. This guide covers: collection setup, authentication, sending messages, testing all message types, and reading webhook responses.

Method	Complexity	Best for
Postman Collection Import	⭐ Easy	Quickest start — import pre-built collection, set API key, run.
Manual request setup	⭐ Easy	Build requests from scratch — good for learning the API structure.
Automated test scripts	⭐⭐ Medium	Write Postman tests to validate responses and automate QA.

Integration Methods

Step-by-step connection guides

Method 2 Postman Test Scripts — Automate QA

Add test script to verify response structure

In Postman: Tests tab of any request. Write JavaScript to verify the response. Tests run automatically after each request send.

Test successful message send

pm.test("Message sent", () => { pm.response.to.have.status(200); const b = pm.response.json(); pm.expect(b.messages).to.be.an("array"); pm.expect(b.messages[0].id).to.include("wamid."); });

Save message ID as variable

Extract the wamid for use in status check requests: const id = pm.response.json().messages[0].id; pm.environment.set("last_message_id", id);

Run collection as automated suite

Collection Runner → select WA.Expert collection → set environment → Run. All requests run sequentially with test assertions. Use this to validate API after any credential or template changes.

// Postman Test Script (Tests tab)
pm.test("Status 200", () =>
  pm.response.to.have.status(200));

pm.test("Has message ID", () => {
  const body = pm.response.json();
  pm.expect(body.messages).to.be.an("array");
  pm.expect(body.messages[0].id)
    .to.include("wamid.");
  
  // Save for next request
  pm.environment.set("last_msg_id",
    body.messages[0].id);
});

pm.test("Contact resolved", () => {
  const contact = pm.response.json().contacts[0];
  pm.expect(contact.wa_id).to.be.a("string");
});

FAQ

Common questions

How do I get the WA.Expert Postman collection?

The WA.Expert Postman collection is available in your WA.Expert dashboard under Developer → API Reference → Download Postman Collection. It includes all endpoints: send message, send template, get templates, upload media, check delivery status, and manage contacts.

What API key should I use for Postman testing?

Use a test/development API key, not your production key, for Postman testing. In WA.Expert dashboard: Settings → API Keys → Create New Key → Label it "Postman Testing". This keeps test traffic separate from production analytics.

Why am I getting "template not found" error in Postman?

The template_name must exactly match the approved template name in your WA.Expert account — case-sensitive, no spaces. Find your approved template names in WA.Expert → Templates → Active Templates. Copy the name exactly as shown.

How do I test sending a WhatsApp with an image attachment in Postman?

First upload the image via the media upload endpoint (POST /v1/media with multipart/form-data body). Get the media_id from the response. Then send a message with type:"image" and media_id in the body. Postman's form-data body type handles multipart uploads.

Can I use Postman to simulate incoming WhatsApp messages (webhook)?

Postman can't simulate Meta sending webhook events to your server. For webhook testing: use Postman's built-in Mock Server to capture and inspect webhooks, or use ngrok + your actual server. Alternatively, send a message to your WhatsApp number from your personal phone and observe the webhook payload your server receives.

What is the rate limit for WA.Expert API calls?

WA.Expert API rate limits: 100 requests/second per API key for sending messages. 1,000 requests/minute for all other endpoints. Meta's underlying limits: 80 messages/second per phone number, 1,000 unique users/day on Tier 1 (scales with tier). Postman testing counts against these limits — use a test API key to keep test traffic separate.

Ready to start testing the WhatsApp API?

Get your WA.Expert API key, import the Postman collection, and send your first WhatsApp message in under 5 minutes.

Start Free Trial → Talk to Developer