Developer Platform

Build AI Sales Infrastructure
with the Vendo AI API

Full programmatic control over an autonomous AI sales system. Create agents, run multi-channel campaigns, automate signal-based prospecting, manage audiences — via REST API or MCP for AI assistants.

143REST Endpoints
113MCP Tools
11API Scopes
v1Stable API
Full API Documentation Get Your API Key

What You Can Build

The Vendo AI platform exposes every capability as an API endpoint. Here's what becomes possible when your sales infrastructure is fully programmable.

AI Agent Lifecycle

Create AI sales agents programmatically. Scan websites, generate sales scripts, set avatars, configure voice settings, connect Google Meet and Telegram — all without opening the dashboard.

35 MCP tools · 59 endpoints

Multi-Channel Campaigns

Launch outreach across email, LinkedIn, voice calls, WhatsApp, and Telegram. Pause channels individually, preview costs, archive campaigns. The AI personalizes every message.

14 MCP tools · 18 endpoints

CRM & Lead Pipeline

Access your live sales pipeline programmatically. Read leads, move cards between stages, reply to prospects on their source channel (LinkedIn or email), enrich contacts from LinkedIn, and manage custom kanban stages.

17 MCP tools · 16 endpoints

Audience Search & Build

Search a verified B2B database by position, country, industry, company size, and technology stack. Save matched contacts as reusable audiences. Feed them into campaigns or download as CSV.

2 MCP tools · 4 endpoints

SDR Signal Pipeline

9 autonomous AI hunters scan LinkedIn jobs, company activity, Hacker News, Crunchbase, G2 reviews, tech stacks, and more. Create signal searches, monitor discovered personas, launch outreach to hot leads.

34 MCP tools · 37 endpoints

Billing & Usage Analytics

Read-only access to balance, subscriptions, invoices, and credit usage. Track spend by agent, by channel, by action type. Monitor SDR email capacity and plan limits.

13 MCP tools · 13 endpoints

MCP for AI Assistants

Connect Claude, ChatGPT, Cursor, or Windsurf to the Vendo AI MCP server. Your AI assistant can create agents, search audiences, launch campaigns, and monitor signals — in natural language.

113 tools · Streamable HTTP

Two Interfaces, One Engine

Pick the one that fits your workflow — or use both. Same API key, same permissions, same capabilities.

REST API

  • Base URL: https://api.vendo-ai.com/v1
  • 143 endpoints across 6 domains
  • JSON request/response format
  • Idempotency keys for safe retries
  • Rate limit: 60 req/min per key
  • Works from any language — Python, Node.js, Go, cURL

MCP Server

  • Server URL: https://api.vendo-ai.com/mcp
  • 113 tools matching all API capabilities
  • Streamable HTTP transport
  • Works with Claude, ChatGPT, Cursor, Windsurf
  • Same API key, same permission scopes
  • Natural language control over sales infrastructure

How Requests Flow

Every request follows the same security pipeline — whether it comes from your code or an AI assistant.

Your App / AI

REST call or MCP tool

→

API Gateway

Auth, rate limit, scope

→

Workspace Isolation

Key → workspace_id

→

Vendo AI Engine

Execute & respond

Destructive Action Safety

Every dangerous operation requires a two-step flow: preview with dry_run, then confirm to execute. A leaked key can't accidentally launch campaigns.

Workspace Isolation

Every API key resolves to a single workspace. The gateway injects workspace_id into all downstream calls. Cross-tenant access is structurally impossible.

Idempotency Support

Pass an Idempotency-Key header on any write request. Same result without re-executing side effects. Keys expire after 24 hours.

No billing:write Scope

Intentionally no billing:write. Top-ups and plan changes happen only in the browser portal. A compromised key cannot move money.

Rate Limiting

60 requests per minute per key. Response headers show remaining budget. X-Idempotency-Replay flags cache hits for retry detection.

SHA-256 Hashed Keys

Keys are stored as SHA-256 hashes, never in plaintext. The full key is shown exactly once at creation. Lose it — generate a new one.

11 Granular Permission Scopes

Every API key is scoped to exactly what it needs. Follow the principle of least privilege — give each integration only the scopes it requires.

agents:readList and inspect AI agents, connections, presentations, widget embed codes
agents:writeCreate, update, scan, script, avatar, voice, connect/disconnect channels
campaigns:readList campaigns, get stats, read outreach content
campaigns:writeCreate, update, archive campaigns and outreach templates
campaigns:controlLaunch, pause, resume, delete campaigns — the destructive operations
audiences:readSearch the B2B database, preview audience sizes
audiences:writeSave audiences, export SDR personas to reusable lists
analytics:readSDR signal stats, hunter health, learning insights, company heat
billing:readBalance, subscriptions, invoices, usage breakdowns — read only, by design
crm:readRead pipeline leads, conversations, stages, stats
crm:writeCreate, update, move, reply, enrich, delete leads; manage stages

Vendo SDR — Signal Intelligence via API

The most unique part of the platform. 9 autonomous AI hunters scan the internet 24/7 for buying signals — and you can control the entire pipeline programmatically.

LinkedIn Jobs

Monitors job postings for signals like hiring sales teams, expanding to new markets, or adopting specific technologies. Highest volume hunter.

Connected People

Analyzes your network for news mentions, role changes, company announcements. Leverages existing connections for warm introductions.

LinkedIn Company

Tracks company-level activity — funding announcements, headcount changes, office expansions, product launches. Company-wide buying signals.

Hacker News

Scans "Who's Hiring" threads and Show HN posts. Catches early-stage companies actively building teams and looking for tools.

AI Web Search

Claude-powered web research that finds companies matching your ICP through semantic understanding. Paid hunter — off by default.

Crunchbase

Funding rounds, acquisitions, leadership changes. Companies that just raised are actively spending on growth tools.

G2 Reviews

Monitors competitor reviews and category browsing. Catches companies actively evaluating alternatives. Paid hunter.

Tech Stack

Detects technology changes — new CRM adoption, marketing tool switches, infrastructure upgrades. Paid hunter.

Email Enricher

Finds and validates work emails for discovered personas. 5 credits per enriched contact. Essential for outreach activation.

All hunters expose run-states, signal-stats, health, and learning-insights endpoints. See full SDR API reference →

What Developers Are Building

Real integration patterns that teams use with the Vendo AI platform.

Custom CRM Integration

Connect your existing CRM or use the built-in Vendo CRM API. Read your live pipeline, move leads between stages, reply on their source channel. When a deal moves to a stage, trigger campaigns automatically.

crm:read + crm:write + campaigns:control

AI-Powered Sales Dashboard

Build an internal dashboard that shows real-time SDR performance, hunter activity, signal heatmaps, and credit usage across all agents — all from API data.

analytics:read + billing:read + agents:read

White-Label Sales Automation

Agencies and integrators build Vendo AI into their own products. Each client gets isolated agents and campaigns via workspace-scoped API keys. Your UI, our engine.

Full API surface with all scopes

AI Assistant That Sells

Connect Claude or ChatGPT to the MCP server. Your AI assistant can search for prospects, create campaigns, launch outreach, and monitor results — all through conversation.

113 MCP tools · Natural language

Get Started in 3 Steps

From zero to your first API call in under 5 minutes.

1

Create an API Key

Go to Settings → API & MCP in the Vendo AI dashboard. Generate a key with the scopes you need. Save it — it's shown only once.

2

Make Your First Call

Hit GET /v1/billing/balance to verify your key works. Then explore agents, campaigns, audiences, or SDR.

3

Build Your Integration

Follow the step-by-step guides in our full documentation — create an agent, search audiences, launch a campaign, set up SDR.

API Pricing

API access is included with every Vendo AI plan. No separate API fees — same credits whether you use the dashboard or the API.

Credit System

Email send1 credit
LinkedIn action1 credit
Voice call (per min)14 credits
Presentation (per min)17 credits
SDR enrichment5 credits

Plans with API Access

Starter$99/mo · 15K credits
Scale$199/mo · 25K credits
Enterprise$1,200/mo · 200K credits
Additional credits$1 = 100 credits

Frequently Asked Questions

What can I build with the Vendo AI API?
You can build complete AI sales infrastructure: create and manage AI agents, run multi-channel campaigns (email, LinkedIn, voice, WhatsApp, Telegram), search and build audiences from a verified B2B database, automate SDR signal-based prospecting with 12 AI hunters, manage your CRM pipeline, and track billing and usage — all via 143 REST endpoints or 113 MCP tools.
How does the MCP integration work?
Vendo AI exposes a Model Context Protocol server at api.vendo-ai.com/mcp with 113 tools. Add it to Claude Desktop, ChatGPT, Cursor, or Windsurf with your API key. Your AI assistant can then call any tool by name — create_agent, search_audience, launch_campaign — using natural language.
Is the API free to use?
API access is included with every Vendo AI plan starting at $99/month. The API uses the same credit system as the dashboard — 1 email = 1 credit, 1 voice minute = 14 credits, etc. There are no separate API fees, no per-call charges, and no hidden costs.
What authentication does the API use?
Bearer token authentication with workspace-scoped API keys. Keys follow the format vnd_live_ + 64 hex characters, are SHA-256 hashed at rest, and support 11 granular permission scopes. Generate keys in Settings → API & MCP.
Can I use the API without the web interface?
Yes — the API provides complete programmatic control. You can create agents, configure their voice and scripts, build audiences, launch multi-channel campaigns, run SDR signal searches, and monitor everything via API. The only actions that remain UI-only are billing operations — by design, for security.
What languages and SDKs are supported?
The API is language-agnostic — any HTTP client works. The MCP server uses Streamable HTTP transport and works with any MCP-compatible client. An OpenAPI spec for auto-generated SDKs is coming soon.
How do destructive actions work?
Every destructive operation (launching campaigns, deleting agents, deep-scanning websites) requires a two-step flow: first call with dry_run: true to preview, then call with confirm: true to execute. This protects against accidental actions from leaked keys or misconfigured automations.

Start Building with Vendo AI

Full API documentation with guides, examples, and endpoint reference. Everything you need to integrate AI sales automation into your product.

Scroll to Top