One WhatsApp API for broadcast, automation, and customer engagement
Manage many WhatsApp numbers, send messages, receive webhooks, and integrate with your stack from one stable, production-ready gateway.
Production endpoints already used by the Genfity team.
Every feature below mirrors a real endpoint in the Genfity gateway, not a marketing promise. Open the docs and run your first request right away.
Session Management
Create, connect, scan QR, monitor status, and log out many WhatsApp sessions from a single API key.
- GET /v1/sessions
- POST /v1/sessions
- GET /v1/wa/session/qr
- POST /v1/wa/session/connect
Chat & Broadcast
Send text, media, and interactive content through simple endpoints — ready for campaigns, notifications, and auto-replies.
- POST /v1/wa/chat/send/text
- POST /v1/wa/chat/send/media
Real-time Webhooks
Receive Message, Connected, Disconnected, and QR events to your endpoint. Reconfigure anytime without restarting a session.
- POST /v1/wa/webhook
- GET /v1/wa/webhook/events
Contacts & History
Access the contact list of an active session and read message history for audit, analytics, or CRM sync.
- GET /v1/sessions/:id/contacts
- GET /v1/wa/session/history
Media Storage (S3)
Wire your own S3 bucket to store conversation media — your data stays under your control, not locked into a vendor.
- GET /v1/wa/session/s3/config
- POST /v1/wa/session/s3/config
HMAC Signed Webhooks
Enable HMAC signing to verify webhook origin so payloads cannot be forged by third parties.
- GET /v1/wa/session/hmac/config
- POST /v1/wa/session/hmac/config
Two API layers designed seriously for production.
Genfity separates the account contract (support layer) from the messaging runtime (gateway layer). You get operational stability and integration freedom.
Account access, subscription, and session lifecycle. Uses the x-api-key header.
Runtime for sending messages, webhooks, S3 media, and HMAC signing.
Four steps from signup to first message sent.
Activate plan
Pick a WhatsApp plan from the dashboard. Subscription activates with clear session and message limits.
Create session
POST /v1/sessions returns a session_token. One WhatsApp number = one session.
Scan QR & connect
Fetch the QR via /v1/wa/session/qr and scan it from WhatsApp. Status flips to connected in real time.
Send & receive
Send via /v1/wa/chat/send/text and get inbound events delivered to your webhook URL.
Built for teams that take WhatsApp seriously.
SaaS & Product Teams
Add a WhatsApp channel to your product without building messaging infrastructure from scratch.
Sales & CS Operations
Many agents, many numbers, one centralised control with webhooks into your CRM.
Marketing & Campaign
Structured broadcasts with delivery tracking and reply events flowing into automation.
Internal Notifications
System alerts, reminders, and billing notifications sent straight to customer WhatsApp numbers.
Connects with your favourite stack
Start your WhatsApp integration today.
Activate a plan, create a session, and send the first message in minutes. No need to host your own WhatsApp server.
