Skip to main content
This page is for developers. It covers API keys and programmatic access to Kakiyo. If you’re looking for how to use Kakiyo from the dashboard, see the Dashboard Guides instead.
The Kakiyo Public API gives you full programmatic access to manage agents, campaigns, prospects, products, prompts, analytics, webhooks, and more. Authenticate with API keys and integrate Kakiyo into your existing workflows.

​
Creating an API Key

  1. Navigate to API Keys in the sidebar.
  2. Click Create API Key.
  3. Enter a name (e.g., “Production CRM Sync”).
  4. Copy the generated 40-character key immediately. It is shown only once.
Security: Store your API key securely. Never expose it in client-side code or public repositories.

​
Authentication

All API requests require a Bearer token in the Authorization header:
The API validates your key and checks your subscription status before processing the request.

​
Available Endpoints

Base URL: https://api.kakiyo.com/v1

​
Agents

  • GET /agents - List all agents
  • POST /agents - Create an agent
  • PUT /agents/:id - Update agent settings
  • POST /agents/:id/pause / resume - Control agent state

​
Campaigns

  • GET /campaigns - List all campaigns
  • POST /campaigns - Create a campaign
  • GET /campaigns/:id/stats - Get campaign statistics
  • POST /campaigns/:id/pause / resume

​
Prospects

  • POST /prospects - Add a single prospect
  • POST /prospects/batch - Batch add prospects
  • POST /prospects/sales-navigator - Queue a Sales Navigator people search import
  • POST /prospects/batch/round-robin - Distribute across campaigns
  • GET /prospects/imports/:listId - Check a direct prospect import
  • GET /prospects/search - Advanced search with filters
  • GET /prospects/:chatId - Get prospect details and messages
  • POST /prospects/:chatId/qualify - Mark as qualified

​
Products & Prompts

  • GET /products / POST /products
  • GET /prompts / POST /prompts

​
Analytics

  • GET /analytics/overview - Full analytics overview
  • GET /analytics/campaigns/:id - Detailed campaign analytics

​
Other Endpoints

  • /webhooks - Manage webhooks programmatically
  • /dnc - Manage Do Not Contact lists
  • /models - List available AI models
  • /workspaces - Manage agency client workspaces
  • GET /verify - Verify API key validity

​
Rate Limits and Usage

Kakiyo uses team-scoped rate-limit tiers rather than one universal limit: Sales Navigator imports use the low write tier and allow at most three active imports per team through the public API.
  • Pagination: Search results are capped at 100 per page. Use limit and offset parameters where supported.
  • Bulk operations: Max 100 prospects per direct batch request.

​
Full Documentation

For detailed endpoint documentation with request/response examples, visit docs.kakiyo.com.
Last modified on August 12, 2026