---
title: "TalaLevel API"
description: "The TalaLevel developer docs: a REST API, webhooks, an MCP server for Claude and ChatGPT, and a command line, for a sales CRM with a dialer, texting and an AI assistant."
url: https://talalevel.com/docs/
date: 2026-11-12
updated: 2026-11-12
---

# TalaLevel API

TalaLevel is a sales CRM with a power dialer, texting from your own numbers and Tala, an AI assistant. Everything in it can be reached from your own code or an AI app: a REST API, webhooks, an MCP server and a command line.

The TalaLevel API is organized around REST. It has predictable resource URLs, takes JSON request bodies, returns JSON, and uses standard HTTP status codes and verbs.

A key belongs to one workspace and can do only what its owner allowed: read, change, or send, area by area. Every send goes through the same checks as a send in the app, so opt-outs, quiet hours and your numbers' registration always hold.

New here? Start with the [quickstart](https://talalevel.com/docs/quickstart/). Using Claude, ChatGPT or Cursor? Connect the [MCP server](https://talalevel.com/docs/mcp/) and skip the code.

**Base URL**

```text
https://app.talalevel.com/api/v1
```

**MCP server**

```text
https://app.talalevel.com/mcp
```

**OpenAPI 3.1**

```text
https://talalevel.com/openapi.json
```

## Four ways in

| Way in | For | Docs |
| --- | --- | --- |
| REST API | Your own code, Zapier, Make, a spreadsheet | [API reference](https://talalevel.com/docs/api/) |
| Webhooks | Being told when a lead is made, texts back, a call ends, a deal is won | [Webhooks](https://talalevel.com/docs/webhooks/) |
| MCP server | Claude, ChatGPT, Cursor and other AI apps working your leads | [MCP server](https://talalevel.com/docs/mcp/) |
| Command line | Scripts and coding agents in a terminal | [Command line](https://talalevel.com/docs/cli/) |

All four work on the same workspace with the same permissions.

**Your first call**

```sh
curl https://app.talalevel.com/api/v1/leads?limit=1 \
  -H "Authorization: Bearer $TALALEVEL_KEY"
```

## Not a developer?

Connect TalaLevel to Claude or ChatGPT as a custom connector with the MCP server's address, sign in, and ask in plain words: who to call back, what a lead said last week, which deals are stuck. Nothing reaches a lead until you say yes. See [MCP server](https://talalevel.com/docs/mcp/).

## Questions

### Does TalaLevel have an API?

Yes. A REST API at https://app.talalevel.com/api/v1 with workspace keys, webhooks for eleven events, an MCP server at https://app.talalevel.com/mcp for AI apps, and a command line, npx talalevel.

### Which plans include the API?

The API, webhooks and the MCP server are part of every plan. Sending texts through them needs a plan with texting, and AI caller runs need the Scale plan, the same as in the app.

### Is there an OpenAPI file?

Yes, OpenAPI 3.1 at https://talalevel.com/openapi.json.

## Pages

- [Quickstart: your first TalaLevel API call](https://talalevel.com/docs/quickstart/): Make a TalaLevel API key, read your leads, add one, and get a webhook when a lead texts back. Five minutes, with curl examples you can paste.
- [Authentication, permissions, errors and limits](https://talalevel.com/docs/authentication/): How TalaLevel API keys work: the Bearer header, a permission level for each area, the error codes, rate limits and cursor paging.
- [REST API reference](https://talalevel.com/docs/api/): Every TalaLevel REST endpoint: leads, notes, texts, calls, emails, lists, pipelines, deals, sending, batches and AI caller runs, with bodies and answers.
- [Webhooks](https://talalevel.com/docs/webhooks/): TalaLevel webhooks: eleven events for leads, texts, calls, meetings, payments and deals, the JSON body, the Standard Webhooks signature and the retry schedule.
- [MCP server reference](https://talalevel.com/docs/mcp/): The TalaLevel MCP server: its address, OAuth sign-in, and every tool an AI app gets for leads, calls, texts, emails, tasks, lists, deals and sending.
- [Command line and Claude Code plugin](https://talalevel.com/docs/cli/): npx talalevel runs every TalaLevel tool from a terminal with a workspace key. The Claude Code plugin adds the connector and a skill for working a sales floor.