Quick Start

Kashew is an AI-powered CRM platform for sales teams. This guide shows you how to use the Public API to manage leads, accounts, opportunities, and more programmatically.

Base URL: https://kashew.ai/api/v1

Get Your API Key

1Visit https://kashew.ai and sign up
2Go to Settings → API Keys
3Create a new API key (format: kshw_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx)
4Keep it secure — never share or commit to code

Your First API Call

List your leads with a simple GET request:

bash

curl -X GET "https://kashew.ai/api/v1/leads?page=1&pageSize=10" \
  -H "Authorization: Bearer kshw_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

200

{
  "leads": [...],
  "totalCount": 42,
  "page": 1,
  "pageSize": 10,
  "totalPages": 5
}

Create a Lead

bash

curl -X POST "https://kashew.ai/api/v1/leads" \
  -H "Authorization: Bearer kshw_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "companyName": "Acme Corp",
    "personName": "Jane Doe",
    "email": "jane@acme.com",
    "jobTitle": "CTO"
  }'

200

{ "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "status": "created" }

API Key Scopes

API keys have scopes that control what they can access:

Scope	Access
crm:read	Read leads, accounts, opportunities, activities
crm:write	Create and update CRM records
prospects:read	Read prospect data
analytics	Access dashboard analytics
*	Full access (all scopes)

Next Steps

→Authentication— learn about API key management
→Leads API— create and manage leads
→Code Examples— Python, JavaScript, Flutter, cURL