# HostMentor Docs

> Developer documentation for the HostMentor WhatsApp Business API.

## WhatsApp Business API

- [WhatsApp Business API](https://docs.hostmentor.com/whatsapp): Send and receive WhatsApp messages from your own software with the HostMentor WhatsApp Business API: templates, media, product catalogs, payments and webhooks.
- [Account](https://docs.hostmentor.com/whatsapp/account): Look up your WhatsApp numbers, phone number IDs and WhatsApp Business Account details with the API.
- [Use with AI assistants (MCP)](https://docs.hostmentor.com/whatsapp/ai-assistants): Install the HostMentor docs MCP server in Claude Code, Cursor, VS Code, Windsurf, Gemini CLI, Codex, Claude or ChatGPT, so your AI assistant can search and read these docs while it writes your integration.
- [Authentication](https://docs.hostmentor.com/whatsapp/authentication): Authenticate WhatsApp Business API requests with your HostMentor API key in the apikey header, and keep your keys safe on your server.
- [Catalog](https://docs.hostmentor.com/whatsapp/catalog): Connect your product catalog to WhatsApp, manage products with the API, and send single-product, multi-product and carousel messages.
- [Changelog](https://docs.hostmentor.com/whatsapp/changelog): Changes to the HostMentor WhatsApp Business API, version by version.
- [Errors](https://docs.hostmentor.com/whatsapp/errors): WhatsApp Business API error format and error codes such as 131047, 130429, 132000 and 132001, what each means and how to fix it.
- [Webhook events](https://docs.hostmentor.com/whatsapp/events): Every WhatsApp webhook event with its payload: incoming messages, message statuses, template updates, number quality and account alerts.
- [Flows](https://docs.hostmentor.com/whatsapp/flows): Set up the encryption keys that WhatsApp Flows use to exchange data securely with your server.
- [IDs and phone numbers](https://docs.hostmentor.com/whatsapp/ids-and-phone-numbers): The IDs you use with the WhatsApp Business API, from phone_number_id and waba_id to message, media, template and catalog IDs, and how to write phone numbers.
- [Media](https://docs.hostmentor.com/whatsapp/media): Upload images, video, audio and documents for WhatsApp messages, and download the files your customers send you.
- [Messages](https://docs.hostmentor.com/whatsapp/messages): Send WhatsApp messages through the API: text, images, documents, reply buttons, lists, products, payment requests, reactions and approved templates.
- [The 24-hour window](https://docs.hostmentor.com/whatsapp/messaging-window): WhatsApp's 24-hour customer service window: when you can send any message, and when you must send an approved template instead.
- [Payments](https://docs.hostmentor.com/whatsapp/payments): Accept UPI, card and netbanking payments inside WhatsApp in India through Razorpay or PayU, check payment status and issue refunds.
- [QR codes](https://docs.hostmentor.com/whatsapp/qr-codes): Create WhatsApp QR codes and short links that open a chat with your business and a prefilled message.
- [Quickstart](https://docs.hostmentor.com/whatsapp/quickstart): Send WhatsApp messages from your own software: get an API key, find your phone number ID and send your first template message in three steps.
- [Rate limits](https://docs.hostmentor.com/whatsapp/rate-limits): WhatsApp API rate limits: messages per second, the daily messaging limit for new customers, per-customer limits and how to handle error 130429.
- [Template samples](https://docs.hostmentor.com/whatsapp/template-samples): Upload sample images, videos and documents so you can create WhatsApp templates with media headers.
- [Templates](https://docs.hostmentor.com/whatsapp/templates): WhatsApp message templates: categories, approval, placeholders, buttons and rules. Create, list, edit and delete templates with the API.
- [Base URL and versions](https://docs.hostmentor.com/whatsapp/versioning): The WhatsApp API base URL is https://wa.hostmentor.com/v3. How v3 stays stable, what counts as a breaking change and how much notice you get.
- [Webhooks](https://docs.hostmentor.com/whatsapp/webhooks): Receive incoming WhatsApp messages and delivery statuses on your webhook, verify the X-HostMentor-Signature header, and handle retries and duplicates.
- [List your phone numbers](https://docs.hostmentor.com/whatsapp/account/list-phone-numbers): List the WhatsApp numbers your API key can use, with their phone number IDs and WhatsApp Business Account ID.
- [Retrieve your business account](https://docs.hostmentor.com/whatsapp/account/retrieve-business-account): Get your WhatsApp Business Account's name, currency, time zone and template namespace.
- [Create, update or delete products](https://docs.hostmentor.com/whatsapp/catalog/batch-products): Create, update or delete products in your WhatsApp catalog in one batch request, using your own product IDs (SKUs).
- [List products](https://docs.hostmentor.com/whatsapp/catalog/list-products): List and search the products in your WhatsApp product catalog.
- [Retrieve your catalog ID](https://docs.hostmentor.com/whatsapp/catalog/retrieve-catalog-id): Get the ID of the product catalog connected to your WhatsApp number.
- [Account alert](https://docs.hostmentor.com/whatsapp/events/account-alerts): WhatsApp webhook for account alerts, such as a declined request to raise your messaging limit.
- [Account reviewed](https://docs.hostmentor.com/whatsapp/events/account-review): WhatsApp webhook sent when WhatsApp finishes reviewing your WhatsApp Business Account.
- [Account updated](https://docs.hostmentor.com/whatsapp/events/account-update): WhatsApp webhook for account changes: verification, policy violations, restrictions and bans.
- [Business limits changed](https://docs.hostmentor.com/whatsapp/events/business-capability): WhatsApp webhook sent when your business's messaging limit or number limit changes.
- [Incoming message](https://docs.hostmentor.com/whatsapp/events/incoming-message): WhatsApp webhook for incoming messages: text, media, button and list replies, reactions, orders, locations and ad referrals, with examples.
- [Message status](https://docs.hostmentor.com/whatsapp/events/message-status): WhatsApp webhook for message statuses: sent, delivered, read and failed, with pricing details and error codes.
- [Display name reviewed](https://docs.hostmentor.com/whatsapp/events/phone-number-name): WhatsApp webhook sent when your number's display name is approved or rejected.
- [Number quality and limit changed](https://docs.hostmentor.com/whatsapp/events/phone-number-quality): WhatsApp webhook sent when your number's quality rating or daily messaging limit changes.
- [Template category changed](https://docs.hostmentor.com/whatsapp/events/template-category): WhatsApp webhook sent when WhatsApp moves one of your message templates to another category.
- [Template quality changed](https://docs.hostmentor.com/whatsapp/events/template-quality): WhatsApp webhook sent when a message template's quality rating changes.
- [Template status](https://docs.hostmentor.com/whatsapp/events/template-status): WhatsApp webhook sent when a message template is approved, rejected, flagged, paused or disabled.
- [Retrieve the private key](https://docs.hostmentor.com/whatsapp/flows/retrieve-flows-private-key): Get the private key your WhatsApp Flows endpoint uses to decrypt requests from WhatsApp.
- [Set up the encryption key](https://docs.hostmentor.com/whatsapp/flows/set-flows-encryption-key): Set up the encryption key WhatsApp Flows use to exchange data securely with your server.
- [Delete media](https://docs.hostmentor.com/whatsapp/media/delete-media): Delete a media file you uploaded to WhatsApp so its media ID can no longer be used.
- [Download media](https://docs.hostmentor.com/whatsapp/media/download-media): Download a WhatsApp media file, such as a photo a customer sent, in one step using its media ID.
- [Download media from its URL](https://docs.hostmentor.com/whatsapp/media/download-media-from-url): Download a WhatsApp media file from the temporary URL returned by Retrieve a media URL.
- [Retrieve a media URL](https://docs.hostmentor.com/whatsapp/media/retrieve-media-url): Get a temporary download link, type, size and checksum for a WhatsApp media file you uploaded or a customer sent.
- [Upload media](https://docs.hostmentor.com/whatsapp/media/upload-media): Upload an image, video, audio file or document to WhatsApp and get a media ID you can send for 30 days.
- [Send a message](https://docs.hostmentor.com/whatsapp/messages/send-message): Send a WhatsApp message with the API: text, images, documents, buttons, lists, products, payment requests, reactions or an approved template.
- [Refund a payment](https://docs.hostmentor.com/whatsapp/payments/refund-payment): Refund all or part of a payment a customer made inside WhatsApp in India.
- [Retrieve a payment](https://docs.hostmentor.com/whatsapp/payments/retrieve-payment): Check whether a WhatsApp Payments request in India has been paid, using your order reference ID.
- [Delete a QR code](https://docs.hostmentor.com/whatsapp/qr-codes/delete-qr-code): Delete a WhatsApp QR code and its short link.
- [List QR codes](https://docs.hostmentor.com/whatsapp/qr-codes/list-qr-codes): List your WhatsApp QR codes and short links, with their prefilled messages and image links.
- [Create or update a QR code](https://docs.hostmentor.com/whatsapp/qr-codes/save-qr-code): Create a WhatsApp QR code and short link that opens a chat with a prefilled message, or change the message of an existing code.
- [Create an upload session](https://docs.hostmentor.com/whatsapp/template-samples/create-upload-session): Start uploading a sample image, video or document for a WhatsApp template with a media header (step 1 of 2).
- [Upload the file](https://docs.hostmentor.com/whatsapp/template-samples/upload-sample-file): Upload a template sample file and get the header handle you need to create a WhatsApp media template (step 2 of 2).
- [Create a template](https://docs.hostmentor.com/whatsapp/templates/create-template): Create a WhatsApp message template and submit it for approval: text, media, buttons, coupons, carousels, catalogs and one-time passwords.
- [Delete a template](https://docs.hostmentor.com/whatsapp/templates/delete-template): Delete a WhatsApp message template in every language or in one language. A deleted name can't be reused for 30 days.
- [List templates](https://docs.hostmentor.com/whatsapp/templates/list-templates): List your WhatsApp message templates with their approval status, category and content, filtered by status and paged.
- [Retrieve a template](https://docs.hostmentor.com/whatsapp/templates/retrieve-template): Get one WhatsApp message template with its approval status, category and content.
- [Edit a template](https://docs.hostmentor.com/whatsapp/templates/update-template): Edit a WhatsApp message template's content or category. The template goes back to review before you can send it again.