The Mumble API: The Complete Guide

In short: The Mumble API lets your developer manage customers, lists, templates and messages from code. You need an API key from Settings and one custom header on every request. For simple automations, Make or Zapier are faster and need no code.

Get your API key

Open Settings and go to Technical Profile.
Under API Key, click the button to create a key if you don’t have one yet.
Click Copy.

Treat the key like a password. There is no button to replace it, so if it leaks, contact Mumble support.

Make your first request

Base URL: https://app.mumble.co.il/mumbleapi/
Headers: Mumble-Api-Key: YOUR_KEY and Content-Type: application/json. Not Authorization: Bearer.
Phone numbers: international format, no + and no leading 0, for example 972501234567.

Main sending endpoints:

send-text-message: free text. Works only while the customer’s 24-hour window is open.
send-template: an approved template, any time. Use the template’s ID from get-templates, not its name.
send-template-text-variable: a template with variables. The variable array fills {{1}}, {{2}} and so on, in order.
is-active-conv: checks if the window is open. If yes, send free text. If not, send a template.

The API also covers customers, lists, agent and team assignment, and creating templates. Campaigns, chatbot editing, Dolores AI and billing are done in Mumble only. Full reference: Mumble API documentation.

Limits and costs

Monthly API calls: each plan includes a quota. See the pricing page.
Speed: too many requests in a short time return 429. Send in a steady pace and retry with a growing delay.
Meta: Meta charges for messages and limits how many customers you can reach with templates. See Meta messaging costs.

Common questions

Every request returns 401

The key is being sent as a Bearer token. Send it in the Mumble-Api-Key header exactly.

I get “Customer not found” for a customer who exists

Check the phone format: digits only, with the country code, no + and no leading 0.

I get “Conversation is closed”

The 24-hour window is closed, so free text can’t be sent. Send a template instead.

My template send fails with 400 or 404

You probably used the template name. Get its ID from get-templates.

Want to Use WhastApp API?

The Mumble API: Key, Authentication, Sending Messages, and Limits

Mumble Team