API keys and webhook URL

Updated June 2026 5 min read

The two pieces that connect WhatsApp to your own software. One lets your app send messages; the other lets WhatsApp tell your app what's happening.

All guides
On this page

Quick facts

API key
Sends messages from your app
Webhook
Notifies your app of events
Needed by most?
No — only for integrations
Key safety
Keep secret, never in frontend

An API key is a secret password that lets your software send WhatsApp messages through ChatMitra. A webhook URL is an address ChatMitra calls to notify your app of events — like a message received or delivered. Together they connect WhatsApp to your CRM, store or custom workflow. Most businesses never need to touch them.

In simple language: An API key is the key to send messages; a webhook is a doorbell that rings your app when something happens.

Who should read this?

  • Developers connecting WhatsApp to an app
  • Owners deciding if they need custom integration
  • Teams syncing WhatsApp with a CRM or store

These two terms scare non-technical owners, but the idea is friendly. They’re only relevant if you want WhatsApp to talk to your own software — otherwise you can skip them entirely.

API key vs webhook: the difference

They work in opposite directions:

API keyWebhook URL
DirectionYour app → WhatsAppWhatsApp → your app
PurposeSend messagesGet notified of events
AnalogyA key to sendA doorbell that rings

Example: an online store uses its API key to send “Order shipped” automatically, and a webhook so that when a customer replies “Where’s my order?”, the store’s system instantly knows.

When you actually need them

Honestly? Most businesses don’t. If you run everything from the ChatMitra dashboard, you never touch these. You only need them to:

  • Send messages from your own app or backend.
  • Sync WhatsApp events into a CRM or database.
  • Build a custom workflow or automation.

Using them safely

Your server  --(API key)-->  ChatMitra  -->  WhatsApp
Your server  <--(webhook)--  ChatMitra  <--  WhatsApp event
  • Keep the API key secret. Store it on your server, never in website/browser code.
  • Revoke and regenerate if a key leaks — anyone with it can send messages on your bill.
  • Reply to webhooks fast with a 200 OK; do heavy work afterward.

For code examples in five languages and payload details, see the Webhook & API feature and the developer docs.

Tools you may need

Keep reading

Related questions people ask

What is a WhatsApp API key?

It's a secret token that lets your software send WhatsApp messages through ChatMitra. Anyone with it can send messages billed to you, so keep it private.

What is a webhook URL?

It's an address on your server that ChatMitra calls to notify your app of events — like a message received, sent, delivered or read — in real time.

Do I need API keys to use ChatMitra?

No. The dashboard works without them. API keys and webhooks are only for connecting WhatsApp to your own software.

Key takeaways

  • API key = lets your app send messages (keep it secret).
  • Webhook URL = lets WhatsApp notify your app of events.
  • Together they connect WhatsApp to your CRM, store or workflow.
  • Most businesses never need them — the dashboard is enough.
Published: June 2026 Last reviewed: June 2026 Reviewed by: ChatMitra WhatsApp API Team

Sources: ChatMitra webhook & API feature

Put WhatsApp to work for your business

Start free on the Starter plan — pay just ₹0.20 per conversation, no subscription. Upgrade to Pro (₹999/month) when you need automation, or Enterprise for zero platform fees at scale.