DEVELOPER RESOURCES

WappBlaster API Documentation

Build custom integrations with our comprehensive API

Introduction

The WappBlaster API allows you to integrate WhatsApp messaging capabilities into your applications. With our API, you can send messages, manage contacts, track conversations, and automate workflows.

Our RESTful API uses standard HTTP response codes, authentication, and verbs. All responses are returned in JSON format.

Base URL

https://api.wappblaster.com/v1

Authentication

All API requests must include an API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Never expose your API key in client-side code. Always make API calls from your server.

API Endpoints

POST/messages

Send a WhatsApp message

Send a text, image, or template message to a WhatsApp number.

Example Request
fetch('https://api.wappblaster.com/v1/messages', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    recipient: '+1234567890',
    type: 'text',
    content: {
      text: 'Hello from WappBlaster API!'
    }
  })
})
GET/contacts

List contacts

Retrieve a list of all contacts in your WappBlaster account.

GET/conversations

List conversations

Retrieve a list of conversations with detailed message history.

Webhooks

Webhooks allow your application to receive real-time notifications about events in your WappBlaster account. Configure webhooks to be notified when messages are received, delivered, read, and more.

Webhook Events

  • message.received - When a new message is received
  • message.sent - When a message is sent
  • message.delivered - When a message is delivered
  • message.read - When a message is read
  • contact.created - When a new contact is created
  • contact.updated - When a contact is updated

SDKs & Libraries

We provide official client libraries for popular programming languages to make integration easier.

JS

JavaScript/Node.js

npm install wappblaster-apiView on GitHub →
PY

Python

pip install wappblasterView on GitHub →
PH

PHP

composer require wappblaster/apiView on GitHub →
C#

C#/.NET

dotnet add package WappBlaster.ApiView on GitHub →

Rate Limits

To ensure the stability of our API, we enforce rate limits on API requests. The limits vary based on your plan:

PlanRequests per minuteMessages per day
Starter601,000
Professional1205,000
Enterprise300Unlimited

Code Examples

Send a text message

// Node.js example const WappBlaster = require('wappblaster-api'); const client = new WappBlaster('YOUR_API_KEY'); client.messages.send({ recipient: '+1234567890', type: 'text', content: { text: 'Hello from WappBlaster API!' } }) .then(response => console.log(response)) .catch(error => console.error(error));

Send a template message

// Node.js example const WappBlaster = require('wappblaster-api'); const client = new WappBlaster('YOUR_API_KEY'); client.messages.sendTemplate({ recipient: '+1234567890', template: { name: 'appointment_reminder', language: { code: 'en_US' }, components: [ { type: 'body', parameters: [ { type: 'text', text: 'John' }, { type: 'date_time', date_time: { fallback_value: 'May 15, 2025' } } ] } ] } }) .then(response => console.log(response)) .catch(error => console.error(error));

Need help with integration?

Our developer support team is ready to help you implement WappBlaster in your application.