Back to DocumentationDeveloper

API Management

Connect your applications to WAB2C using secure REST APIs. Enable API access, generate Bearer tokens, configure endpoints, set granular permissions, and programmatically manage contacts, messages, templates, bots, and groups for custom integrations.

API Overview

The WAB2C API Integration allows your application or software to connect directly with the WAB2C platform using a set of secure and well-designed REST interfaces.

Secure Extension

Add new features or automate tasks in your own app by using the WAB2C API without compromising security.

Seamless Data Exchange

Data flows effortlessly between your system and WAB2C, keeping everything up to date automatically.

Custom Integrations

Create unique connections tailored to your business needs, linking WAB2C with other tools and platforms.

Programmatic Access

Control and interact with contacts, messages, templates, and bots through code for faster workflows.

Enabling API Access

Follow these steps to enable API access for your WAB2C tenant:

Screenshot 1 - API Management Settings Panel

API settings page showing Enable API Access toggle, Generate New Token button, API Base URL field, Tenant Subdomain, and Token Abilities permission checkboxes.

1

Enable API Access

Toggle the switch to enable API access on the settings page.

2

Generate API Token

Click "Generate New Token" to create a new API authentication token.

3

Copy API Base URL

Copy the base URL for API calls. This is your root endpoint for all requests.

4

Note Tenant Subdomain

Use your tenant subdomain in endpoint URLs. This identifies your workspace.

5

Save Changes

Save all your changes to activate the API integration.

API Authentication

All API requests must include a Bearer token in the Authorization header. The token is unique to your tenant and acts as your API password.

ParameterDetails
AuthenticationBearer Token in the Authorization header for all API requests
API TokenUnique token generated for your tenant; acts as your API password
Content-Typeapplication/json

Example Request Header

Authorization: Bearer YOUR_API_TOKEN_HERE
Content-Type: application/json

Security Warning: Never share your API token publicly or commit it to version control. Treat it like a password. If compromised, generate a new token immediately from the API settings page.

API Endpoint Structure

API endpoints follow a consistent URL structure combining the base URL, your tenant subdomain, and the specific resource path.

Screenshot 2 - API Endpoint Configuration

API settings showing Base URL, Tenant Subdomain, and Complete Endpoint structure with copy buttons for each field.

ElementDescription
API Base URLThe root URL where all API requests are sent
Tenant SubdomainYour unique tenant identifier, part of the URL path to specify your workspace
Complete EndpointCombination of API Base URL + Tenant Subdomain + specific resource path

Example: Get WhatsApp Templates

API Base URL: https://app.wab2c.com/api/
Tenant Subdomain: your-tenant
Complete Endpoint: https://app.wab2c.com/api/your-tenant/templates

Token Abilities (Permissions)

Permissions define what actions the API token can perform. Adjust them carefully for security and functionality. Each permission can be individually enabled or disabled.

CategoryPermissionsDescription
ContactsCreate, Read, Update, DeleteManage contact information (add, view, modify, remove)
StatusesCreate, Read, Update, DeleteHandle status updates for contacts or campaigns
SourcesCreate, Read, Update, DeleteManage sources of contacts or message data
TemplatesReadAccess WhatsApp message templates for sending messages
Message BotsReadView and manage message bot configurations
Template BotsReadView and manage template bot configurations
GroupsCreate, Read, Update, DeleteManage contact groups for segmented messaging
Message SendingText, Media, TemplatePermission to send text messages, media messages, and template messages via WhatsApp

Best Practice: Follow the principle of least privilege. Only enable the permissions your integration needs. For a read-only dashboard, enable only Read permissions. For a full CRM sync, enable CRUD operations on Contacts, Statuses, Sources, and Groups.

API Resources

The WAB2C API provides programmatic access to the following platform resources:

Contacts API

Full CRUD operations on your contact database. Create, read, update, and delete contacts programmatically.

View Contacts Documentation

Templates API

Read access to your WhatsApp message templates for use in sending messages via the API.

View Template Documentation

Message Sending API

Send text messages, media messages (images, documents, videos), and template messages to WhatsApp contacts.

View Campaign Documentation

Bots API

Read access to both Message Bot and Template Bot configurations for monitoring and integration purposes.

View Bot Documentation