Skip to main content

Kula API

Kula is an AI-powered talent intelligence platform. The Kula API lets you integrate recruiting workflows into your applications.

Available APIs​

APIDescription
Job Boards APIEmbed job listings on your website and accept applications
Applications APIManage candidates, applications, jobs, requisitions, and webhooks
CandidatesCreate, search, and update candidate profiles
JobsList jobs, manage pipeline stages, and view stage activities
RequisitionsCreate and manage hiring requisitions
Users & RolesInvite, update, deactivate, and reactivate users; list and inspect roles
OrganizationAccess departments, offices, milestones, and lookup data
WebhooksReceive real-time notifications for recruiting events

Base URL​

All API requests use:

https://api.kula.ai/v1

Authentication​

Requests require a Bearer token in the Authorization header:

Authorization: Bearer your_api_token_here

See Authentication for setup instructions.

Response Format​

Successful responses return JSON with a data object and pagination metadata:

{
  "data": [...],
  "meta": {
    "total": 42,
    "page": 1,
    "limit": 20,
    "total_pages": 5,
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "req_abc123"
  }
}

All list endpoints default to 20 items per page. Use the limit param (max 100) and page param to paginate. Save the request_id when contacting support.

Error responses include an error code and message:

{
  "error": {
    "code": "ERR_INVALID_TOKEN",
    "message": "The provided API token is invalid"
  }
}

Rate Limits​

The API allows 1,000 requests per hour per account. Rate limit headers are included in every response.

See Rate Limiting for details.

Next Steps​