Wahob supports external connectivity through API-key authenticated endpoints, incoming webhooks, e-commerce callbacks, and public widget flows. Use the v1 API to sync contacts, read conversations, and send WhatsApp text messages from trusted server-side integrations.
Keys are tenant-scoped and may expire.
Each key only works for granted scopes.
Limits are configured per key, per minute.
Generate a key in Wahob from Settings, select the scopes your integration needs, store the one-time secret securely, then make calls from your backend.
curl -X GET "https://api.wahob.com/api/v1/contacts?per_page=10" \
-H "Accept: application/json" \
-H "X-Api-Key: wahob_your_key" \
-H "X-Api-Secret: your_secret"These endpoints are designed for trusted server-side integrations. Do not expose your API secret in browser code or mobile apps.
/api/v1/contactsReturns paginated contacts for the API key tenant. Supports search by contact name or phone.
Query parameters: search, per_page
{
"data": [
{
"id": 42,
"name": "Priya Shah",
"phone": "+919876543210",
"email": "priya@example.com",
"source": "api"
}
],
"current_page": 1,
"per_page": 25,
"total": 1
}/api/v1/contactsCreates a contact for the tenant, or returns the existing contact when the phone number already exists.
No query parameters.
{
"phone": "+919876543210",
"name": "Priya Shah",
"email": "priya@example.com",
"custom_fields": {
"city": "Mumbai",
"plan": "Gold"
}
}{
"data": {
"id": 42,
"phone": "+919876543210",
"name": "Priya Shah",
"email": "priya@example.com",
"source": "api"
}
}/api/v1/messages/sendSends a text message through an active Wahob WhatsApp number. The tenant must have an eligible outbound conversation or template/session policy in place.
No query parameters.
{
"phone": "+919876543210",
"message": "Your order has been packed and will ship today.",
"phone_number_id": 12
}{
"message": "Message sent",
"data": {
"provider_message_id": "wamid.HBgM...",
"phone_number_id": 12
}
}/api/v1/conversationsReturns paginated WhatsApp conversations, sorted by latest activity, with the linked contact summary.
Query parameters: per_page
{
"data": [
{
"id": 91,
"channel": "whatsapp",
"status": "open",
"last_message_at": "2026-06-13T08:00:00.000000Z",
"contact": {
"id": 42,
"name": "Priya Shah",
"phone": "+919876543210"
}
}
]
}Wahob also exposes public callback endpoints for webhooks, widgets, and commerce plugins. These are integration callback URLs, not general-purpose API-key endpoints.
/api/webhook/incoming/{slug}Receives events from external tools using the tenant webhook slug.
/api/webhook/ecommerce/{platform}/{integrationId}Receives WooCommerce and Shopify events for connected stores.
/api/ecommerce/woocommerce/auto-connectConnects the Wahob WooCommerce plugin using plugin API key authentication.
/api/widget/{slug}/messagesUsed by the embeddable customer chat widget.
/api/widget/{slug}/appointments/slotsReturns available booking slots for widget visitors.
/api/widget/{slug}/appointments/bookBooks an appointment from the public widget flow.
Use this after granting the `messages.send` scope and connecting at least one active WhatsApp phone number in Wahob.
curl -X POST "https://api.wahob.com/api/v1/messages/send" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-Api-Key: wahob_your_key" \
-H "X-Api-Secret: your_secret" \
-d '{
"phone": "+919876543210",
"message": "Thanks for your order. We will notify you when it ships."
}'401Missing, expired, or invalid API key/secret.
403The key is valid but does not include the required scope.
422Validation failed or the requested WhatsApp action cannot be completed.
500Unexpected server or provider error.