Accounts

Manage customer and prospect accounts. Accounts are created manually or by converting a qualified Lead.

GET/accounts

List accounts with pagination, search, and filters.

Query Parameters

Param	Type	Description
page	int	Page number (default: 1)
pageSize	int	Items per page (default: 100, max: 500)
search	string	Search by name, contact email, industry
status	string	Filter: Active, Inactive
type	string	Filter: Prospect, Enterprise, Mid-Market, SMB
isArchived	boolean	Show archived accounts (default: false)
ownerId	string	Filter by owner (cognito_sub)

Request

curl -X GET "https://kashew.ai/api/v1/accounts?page=1&pageSize=20&status=Active&type=Enterprise" \
  -H "Authorization: Bearer kshw_xxxxxxxx_xxxxx..."

POST/accounts

Create a new account.

Request Body

{
  "name": "Acme Corporation",
  "type": "Enterprise",
  "status": "Active",
  "description": "Enterprise SaaS company",
  "contactEmail": "cto@acme.com",
  "contactPersonName": "John Smith",
  "contactPhone": "+1 555-0123",
  "industry": "SaaS / Software",
  "website": "https://acme.com",
  "country": "United States"
}

201Response

{
  "id": "543d15e7-b45f-47cf-afa4-3f18dc019106",
  "name": "Acme Corporation",
  "type": "Enterprise",
  "status": "Active",
  "relationship_health_score": 0,
  "created_at": "2026-05-20T10:30:00Z"
}

GET/accounts/:id

Get a single account with AI insights (if enriched).

curl -X GET "https://kashew.ai/api/v1/accounts/543d15e7-..." \
  -H "Authorization: Bearer kshw_xxxxxxxx_xxxxx..."

PUT/accounts/:id

Update account fields. Only include fields you want to change.

curl -X PUT "https://kashew.ai/api/v1/accounts/543d15e7-..." \
  -H "Authorization: Bearer kshw_xxxxxxxx_xxxxx..." \
  -H "Content-Type: application/json" \
  -d '{"status": "Inactive", "type": "SMB", "is_archived": true}'

POST/account-enrichment

Trigger AI enrichment for an account. Generates score, recommendations, pitch notes, and use cases.

curl -X POST "https://kashew.ai/api/v1/account-enrichment" \
  -H "Authorization: Bearer kshw_xxxxxxxx_xxxxx..." \
  -H "Content-Type: application/json" \
  -d '{"account_id": "543d15e7-b45f-47cf-afa4-3f18dc019106"}'