Changelog

All notable changes to the LeadsDB API are documented here.

[1.0.0] - December 2025

Initial release of LeadsDB API.

Features

• Core Lead Management

  • Create, read, update, and delete leads via REST API
  • Batch create up to 100 leads in a single request
  • Export leads to CSV or JSON format

• Dynamic Attributes

  • Store custom key-value pairs on leads
  • Support for 5 data types: text, number, bool, list, object
  • Filter leads by custom attributes using attr: prefix

• Advanced Filtering

  • 20+ filter operators for text, numbers, arrays, and location
  • Combine filters with AND/OR logic
  • Location-based search with within_radius operator
  • Full-text search on lead names using FTS

• Notes System

  • Add, update, and delete notes on leads
  • Track customer interactions and follow-ups

• Lead Scoring

  • Define custom scoring expressions
  • Automatic score calculation on lead creation
  • Bulk recalculation for existing leads

• MCP Integration

  • Model Context Protocol (MCP) support
  • OAuth 2.0 with PKCE authentication
  • 13 MCP tools for AI assistant integration
  • Compatible with Claude Desktop, Cursor, and other MCP clients

• Rate Limiting

  • Sliding window rate limiting
  • Plan-based limits (Free: 100/10min, Pro: 1000/10min)
  • Rate limit headers on all responses

• API Features

  • API key authentication (X-API-Key header)
  • Cursor-based pagination
  • Sorting by any field
  • Consistent error responses

API Versioning

The LeadsDB API uses URL versioning. The current version is v1:

Code
 
https://getleadsdb.com/api/v1

We will provide advance notice before introducing any new API versions.