Beleav
Beleav Docs · v1.4.0

Build with Beleav.

Reference for every part of the platform — the assistant, the inbox, scheduling, workflows, the API, and the SDKs. Code samples in TypeScript, Python, and cURL.

⌘K
300+ pages
2 SDKs
99.99% uptime
DocsGetting started

Getting started

Everything you need to ship with the getting started part of Beleav. Read top-to-bottom or jump in anywhere — every page is short and ends with a working sample.

import { Beleav } from "@beleav/sdk";

const beleav = new Beleav({ apiKey: process.env.BELEAV_KEY });

// Reply to an inbound message in the customer's tone.
const reply = await beleav.messages.draft({
  conversationId: "cnv_8a4f",
  intent: "answer-pricing",
  approve: false,        // owner reviews before sending
});

console.log(reply.text);
Build faster

SDKs, types, and webhooks — typed end to end.

@beleav/sdk
TypeScript

Full coverage, fully typed, autocompleting in your editor.

npm i @beleav/sdk
beleav-python
Python 3.10+

Sync + async clients, Pydantic types, retries built in.

pip install beleav
Webhooks
HMAC-signed

Subscribe to 40+ event types. Replay any event from the dashboard.

POST /v1/webhooks
What's new

Changelog.

Read everything we ship. Subscribe to the developer newsletter for breaking changes and new endpoints, two weeks ahead.

Read the dev letter
  1. v1.4.0Apr 22, 2026

    Long-form memory for Beleav assistant; per-customer context window 4x.

  2. v1.3.2Apr 09, 2026

    Webhook signing now uses HMAC-SHA256 with rotating keys.

  3. v1.3.0Mar 24, 2026

    New endpoints: schedules.bookSlot, leads.score, invoices.reconcile.

  4. v1.2.5Mar 11, 2026

    Bulk import for leads (up to 50k rows) now streams.

Build with us

Get an API key in two clicks. First 10,000 calls every month are free.