Introduction

Build, test, deploy, and monitor AI agents.

iMash AI Agent Platform

Here's what iMash offers

Build

Test

Playground
Test your agents quickly.
Simulation
Automate regression tests.

Deploy

Phone Calls
Make and receive calls.
Custom Telephony
Integrate SIP providers.

Monitor

Webhook
Receive events in real-time.
Analytics
Understand agent performance.
API REFERENCE

CRM Leads

Endpoint /api/v2/crm_leads

Request Builder

Response
Click "Execute Request" to see the response

Schema & Fields

Welcome to iMash

iMash puts an AI-powered call center, a full CRM, and a workflow automation engine in one platform. In the next 15 minutes you'll create your first AI voice agent, talk to it live, and give it a real phone number.

⏱️ Time to complete: 15 minutes

What is iMash?

iMash is the platform where your business answers every call, follows up on every lead, and never sleeps. At its heart are AI voice agents — lifelike assistants that answer and make phone calls 24/7, book appointments, qualify leads, and hand off to your human team when it matters. Around them, iMash gives you the whole operation: smart outbound campaigns and predictive dialers, a full CRM with a sales pipeline (quotes, invoices, and payments included), field-service dispatch that texts jobs to technicians automatically, omnichannel messaging across SMS, WhatsApp, and Email, a contact center for human teams, drag-and-drop automations, and real-time analytics on all of it. One login, one place, everything talking to everything else.

The fastest way to feel the magic is to build an agent and hear it speak — so let's do exactly that.

The iMash Overview dashboard with live statistics
Your home base: the Overview dashboard tracks contacts, agents, calls, and spend in real time
The iMash Overview dashboard with live statistics
Your home base: the Overview dashboard tracks contacts, agents, calls, and spend in real time

Your First 15 Minutes — Create an AI Agent

Every great setup starts with one agent. Here's how to bring yours to life:

  1. In the left sidebar, under Intelligence Center, click Smart Agents.
  2. Click the blue Create New Agent button in the top-right of the list.
  3. Your new agent is created instantly with a placeholder name (like Agent_1234567) and opens straight into the visual builder.

Prefer a head start? Click the arrow next to Create New Agent and choose Browse Templates to start from a ready-made agent.

💡 Tip: Don't overthink the first agent — you can rename it, change its voice, and rewrite its instructions at any time. The goal right now is to hear it talk.
Smart Agents list with the Create New Agent button
Smart Agents is your agent roster — click Create New Agent to add one
Smart Agents list with the Create New Agent button
Smart Agents is your agent roster — click Create New Agent to add one

Give It a Brain, a Voice, and a Personality

New agents open in the visual builder — your agent's entire mind on one canvas. The three cards feeding into the Agent node are its senses:

  • LLM card — the language model that does the thinking. Click Model to choose one, and drag Temperature between Precise and Creative (0.7 is a great starting point).
  • TTS card — the text-to-speech voice your callers hear. Click Voice to browse and preview voices.
  • STT card — speech-to-text, how the agent hears. The default multilingual model works out of the box.

On the Agent node itself, set the identity:

  • Name — click it to rename your agent (e.g. "Ben from Support").
  • Persona — the instructions that define who the agent is, what it knows, and how it behaves.
  • Begins — the opening line the agent says when a call starts.
  • Allow interruptions — leave this on so callers can talk over the agent naturally.

Across the top you'll see capability switches — Knowledge Base, Webhooks, Observer Agent, IVR, CRM, Dispatch, Messages, and Widget — each one unlocks a superpower you can explore later.

💡 Tip: Feeling ambitious? Type what you want into the AI Builder bar at the bottom (e.g. "Add an If/Else that branches on caller intent") and iMash will build the flow for you.
The visual agent builder showing LLM, TTS, and STT cards connected to the Agent node
The visual builder: LLM, voice, and speech recognition all wired into your agent on one canvas
The visual agent builder showing LLM, TTS, and STT cards connected to the Agent node
The visual builder: LLM, voice, and speech recognition all wired into your agent on one canvas

Talk to Your Agent — Right in the Browser

This is the moment. No phone number needed yet — you can have a live voice conversation with your agent straight from the builder:

  1. In the bar at the bottom of the canvas, click Live Test.
  2. Click the Start button.
  3. When your browser asks for microphone access, click Allow.
  4. Say hello! The agent answers with its opening line and holds a real conversation. You can also type into the Talk to your agent box to chat by text.
⚠️ Heads-up: If you don't hear anything, check that your browser has microphone permission and your speakers aren't muted — the browser's mic prompt only appears the first time.

Not happy with an answer? Switch back to AI Builder, tweak the persona or opening line, and test again. Iterating takes seconds.

The Live Test bar with the Start button in the agent builder
Flip to Live Test and press Start to talk to your agent instantly
The Live Test bar with the Start button in the agent builder
Flip to Live Test and press Start to talk to your agent instantly

Give Your Agent a Real Phone Number

An agent with a phone number is an employee that never takes a day off. Let's get one:

  1. In the left sidebar, under Call Center, click Phone numbers.
  2. Click Buy New Number in the top-right.
  3. In the modal, pick your Country.
  4. Under Required capabilities, keep Voice checked (add SMS if you also want texting on this number).
  5. Type an Area code, locality, or prefix (e.g. 212) and click Search.
  6. Select the numbers you like from the list — the Total shows the monthly price — then click Buy Numbers.
💡 Tip: If the modal shows an Add a payment method first banner, click the link inside it to save a card — then come back and buy your number.

Already have numbers with another carrier? Use Import Number, or connect your own trunk under SIP Providers in the sidebar — iMash plays nicely with the phone system you already own.

The Phone Numbers page with Buy New Number and Import Number buttons
The Phone Numbers page — buy new numbers or import ones you already own
The Phone Numbers page with Buy New Number and Import Number buttons
The Phone Numbers page — buy new numbers or import ones you already own
The Buy New Number modal with country, capabilities, and area code search
Pick a country, choose capabilities, search an area code — done
The Buy New Number modal with country, capabilities, and area code search
Pick a country, choose capabilities, search an area code — done

Connect the Agent to the Number — and Make the First Call

Last wiring step — tell the number who should pick up:

  1. On the Phone Numbers page, click the number you just bought. The Phone Number Details panel opens.
  2. On the Settings tab, under Inbound Settings, set Call Handling to Enable Agents.
  3. In the Inbound Agent dropdown, select the agent you created.
  4. Click Save Settings.
  5. Now the payoff: call the number from your own phone. Your agent picks up, greets you with its opening line, and handles the conversation — you can also click Test Call in the panel to trigger a test.

That's it — you now have an AI employee with its own phone line. Every call it takes shows up in Call Logs with a full transcript, recording, and AI-generated summary.

💡 Tip: The Warm Transfer and Cold Transfer options let a number forward callers to a human or another line instead of (or after) the AI — perfect when you're ready to blend AI and human teams.
Phone Number Details panel with Call Handling and Inbound Agent settings
Set Call Handling to Enable Agents and pick your agent as the Inbound Agent
Phone Number Details panel with Call Handling and Inbound Agent settings
Set Call Handling to Enable Agents and pick your agent as the Inbound Agent

Explore the Platform

Your agent is live — and you've only scratched the surface. Here's the rest of the iMash universe, one click away:

  • AI Voice Agents — knowledge bases, tools, sub-agents, custom variables, and website embeds turn a simple agent into a specialist team. Build smarter agents →
  • Phone System — numbers, SIP providers, call routing, PBX extensions, and voicemail, all managed in one place. Set up your phone system →
  • Contact Center — a full workspace for human teams: skill groups, queues, ring strategies, live monitoring, whisper and barge. Tour the Contact Center →
  • Campaigns & Dialers — upload a dial list and let AI agents (or a predictive dialer feeding your human reps) work through it automatically. Launch a campaign →
  • CRM — leads, contacts, accounts, tasks, calendar, and online booking forms, all connected to every call and message. Organize your CRM →
  • Sales Pipeline — deals, quotes, invoices, subscriptions, and card payments, from first touch to paid-in-full. Work your pipeline →
  • Field-Service Dispatch — jobs auto-texted to technicians, first-to-accept wins, with customer notifications along the way. Automate dispatch →
  • Messages — SMS, WhatsApp, and Email in unified inboxes, with AI text agents that reply on every channel. Master messaging →
  • Marketing — import contact datasets, scrape local businesses, and build lead lists ready to dial. Find new leads →
  • Automations — visual smart flows, custom tools, webhooks, and MCP servers that connect iMash to everything else. Automate your workflows →
  • Analytics — dashboards, reports, and per-call cost breakdowns so you always know what's working. Measure everything →
  • Settings — team members and roles, billing, security, audit log, and full white-label branding. Configure your workspace →

Need Help?

If you run into any issues or have questions:

Build Overview

Design agents, configure flows, and connect tools.

Create Agent

Define goals, voice, and integrations. Save to start testing immediately.

API Reference

All requests require the x-api-key header.

Base /api/v2/
ADD LIST UPDATE DELETE

List Contacts

curl -X GET "/api/v2/contacts?limit=10&order_by=created_at desc" \
  -H "x-api-key: YOUR_SECRET_API_KEY"

Create Contact

curl -X POST "/api/v2/contacts" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_SECRET_API_KEY" \
  -d '{"name":"Ada Lovelace","phone":"+15551234567"}'

Video Tutorials

Learn how to use iMash with step-by-step video guides.

Video Title