API & Webhooks Guide
For advanced users and developers, Kazi provides a REST API and webhook system to integrate with your existing tools and workflows.
REST API Overview
Kazi's API follows RESTful conventions with JSON request and response bodies. Endpoints are organized by module: /api/invoices, /api/projects, /api/clients, /api/ai/agents, and more. All endpoints require authentication via API key or session cookie.
Authentication
Generate an API key from Settings > Developer > API Keys. Include the key in your request headers as a Bearer token. API keys have the same permissions as your user account and can be revoked at any time.
Webhooks
Webhooks let Kazi notify your systems when events happen — invoice paid, project created, payment received, etc. Configure webhook endpoints in Settings > Developer > Webhooks. Kazi sends a POST request with event details to your URL in real time.
Common Integration Patterns
Popular integrations include syncing invoices with accounting software (QuickBooks, Xero), sending payment notifications to Slack, updating project boards in Notion or Trello, and triggering custom workflows in Zapier or Make.
Rate Limits
API requests are rate-limited to protect service quality. General endpoints allow 300 requests per minute, AI endpoints allow 60 per hour, and payment endpoints allow 30 per minute. Rate limit headers are included in every response so you can monitor your usage.
