HookMessage developer docs
Build the message path. Understand every response.
Start with a managed Free Sandbox sender, then connect your own number when you are ready. Every guide explains what to click, what to send, what success looks like, and how to fix failures.
curl -X POST https://api.hookmessage.com/api/otp/send \
-H "x-api-key: $HOOKMESSAGE_API_KEY" \
-H "content-type: application/json" \
-d '{
"receiver_number": "212612345678",
"app_name": "My product",
"ttl_minutes": 10
}'Priority paths
Choose the job you need to complete.
Each guide includes dashboard steps, request details, expected results, and failure guidance.
New to HookMessage
Choose your setup
Understand Free Sandbox and paid sender mode before creating an integration.
No number required
Free Sandbox
Create an OTP key and send a test request through a managed HookMessage sender.
Live delivery
Connect your number
Upgrade, link your WhatsApp number, assign it to a key, and send with its sender ID.
Something failed
Fix an integration
Start with the response code, then follow the exact checks for auth, routing, queue, and delivery.
Documentation index
Find the exact implementation detail.
Getting Started
Start here
Choose the correct setup path before you create an API key or connect a WhatsApp number.
Getting Started
Free Sandbox quickstart
Create an API key and send your first OTP without connecting or selecting a WhatsApp number.
Getting Started
Glossary
Plain-language definitions for the names used in the dashboard, API responses, and integration guides.
Getting Started
Authentication and access
Understand API keys, customer sessions, internal access, and workspace isolation.
Core Concepts
Workspaces
Understand how HookMessage scopes senders, API keys, messages, contacts, billing, and team access.
Core Concepts
Senders and sessions
Create connected numbers, scan QR codes, check health, and understand sender states.
Messaging
Send customer messages
Queue customer notifications, confirmations, reminders, and support messages.
Messaging
Send OTP
Send a WhatsApp verification code with stricter OTP validation and rate limits.
Core Concepts
Message queue
Understand what happens after the API accepts a message and how to build reliable retry behavior.
Messaging
Message status and history
Track queued messages until they are sent or failed.
Administration
API keys and sender assignment
Create API clients, rotate keys, revoke access, and restrict keys to selected senders.
Automation
Webhooks and automation
Receive signed delivery events and automation events in your application.
Reliability
Errors and limits
Handle validation errors, sender problems, quota limits, and rate limits cleanly.
Developer Tools
SDK setup and examples
Use the TypeScript, Python, and PHP reference clients safely from a backend service.
Developer Tools
REST API
Use the HTTP API directly from your backend for sender discovery, OTP, custom messages, message status, and OpenAPI reference.
Getting Started
Troubleshooting
Fix common setup errors for API keys, senders, phone numbers, quotas, webhooks, OpenAPI, and SDK timeouts.
Developer Tools
Complete integration examples
Copy complete backend examples for Node/Express, Next.js, Laravel, Python, and plain PHP.
Security
Production readiness checklist
Verify API keys, sender status, message status, webhooks, quotas, and operator recovery before launch.
Messaging
Message templates
Create reusable message templates for dashboard and automation workflows.
Core Concepts
Contacts and segments
Store customer contact records and group them into segments for workflows.
Automation
Inbox and automation
Use conversations, internal notes, replies, and workflow rules around customer messages.
Administration
Billing and plans
Understand plan limits, billing summary, checkout, portal, cancellation, and recovery endpoints.
Security
Security and compliance
Use workspace isolation, key rotation, audit logs, blocked recipients, and SSO safely.
API reference
Start with cURL. Move the verified request into your framework.
Need implementation help?
Review the complete integration path.
Compare backend patterns, sender setup, credential storage, webhook verification, and production checks.