Applications API

The Applications API (also known as the ATS API) is designed for server-to-server integrations. It provides full access to manage candidates, applications, jobs, and webhooks.

Server-Side Only: This API should NOT be called from client-side code. API tokens for this API have elevated permissions and must be kept secure on your server.

Key Characteristics

Feature	Description
Server-to-server	Must be called from your backend
Full access	Read and write operations
Webhook management	Create and manage webhooks
Sensitive data	Access to candidate information

Use Cases

HRIS integrations — Sync candidates with your HR systems
Workflow automation — Trigger actions based on recruiting events
Custom reporting — Build analytics dashboards
Webhook management — Configure event subscriptions

Server-Side Example

Call the Applications API from your backend:

// Node.js server-side example
const token = process.env.KULA_API_TOKEN; // Keep token secure

async function getCandidates() {
  const response = await fetch(
    'https://api.kula.ai/v1/candidates',
    {
      headers: {
        'Authorization': `Bearer ${token}`,
        'Content-Type': 'application/json'
      }
    }
  );

  return response.json();
}

Available Endpoints

Candidates

Endpoint	Description
`GET /v1/candidates`	List candidates
`POST /v1/candidates`	Create a candidate
`POST /v1/candidates/search`	Search candidates with rich filters
`GET /v1/candidates/{id}`	Get candidate details
`PATCH /v1/candidates/{id}`	Update a candidate
`POST /v1/candidates/{id}/resumes`	Upload a resume to a candidate

Applications

Endpoint	Description
`GET /v1/applications`	List applications
`GET /v1/applications/{id}`	Get application details
`PATCH /v1/applications/{id}/stage`	Move application to a stage
`POST /v1/applications/{id}/files`	Upload a file to an application
`GET /v1/applications/{id}/scorecards`	List scorecards for an application
`GET /v1/applications/{id}/notes`	List notes on an application
`POST /v1/applications/{id}/notes`	Add a note to an application
`PATCH /v1/applications/{id}/notes/{note_id}`	Update a note

Interviews

Endpoint	Description
`GET /v1/interviews/{id}/transcript`	Get an interview transcript
`GET /v1/interviews/{id}/ai_notes`	List AI notes for an interview

Scorecards

Endpoint	Description
`GET /v1/scorecards`	List scorecards
`GET /v1/scorecards/{id}`	Get scorecard details
`PATCH /v1/scorecards/{id}`	Update a scorecard
`POST /v1/scorecards/{id}/submit`	Submit a scorecard
`POST /v1/scorecards/{id}/remind`	Send a scorecard reminder
`POST /v1/scorecards/{id}/attachment_uploads`	Create a scorecard attachment upload link
`DELETE /v1/scorecards/{id}/attachments/{attachment_id}`	Delete a scorecard attachment

Jobs

Endpoint	Description
`GET /v1/jobs`	List jobs
`POST /v1/jobs/search`	Search jobs with filters
`GET /v1/jobs/{id}`	Get job details
`POST /v1/jobs`	Create a job
`PATCH /v1/jobs/{id}`	Update a job
`PATCH /v1/jobs/{id}/hiring_team`	Update a job's hiring team
`POST /v1/jobs/{id}/job_post`	Create a job post
`PATCH /v1/jobs/{id}/job_post`	Update a job post
`POST /v1/jobs/{id}/publish`	Publish or schedule a job
`POST /v1/jobs/{id}/close`	Close a job
`POST /v1/jobs/{id}/reopen`	Reopen a job
`POST /v1/jobs/{id}/archive`	Archive a job
`POST /v1/jobs/{id}/approve`	Approve a job
`POST /v1/jobs/{id}/reject`	Reject a job
`POST /v1/jobs/{id}/approval_reminders`	Send a job approval reminder
`GET /v1/jobs/{id}/stages`	List stages for a job
`POST /v1/jobs/{id}/stages`	Create a stage for a job
`GET /v1/jobs/{id}/stages/{stage_id}/activities`	List activities for a stage

Requisitions

Endpoint	Description
`GET /v1/requisitions/fields`	List available requisition fields
`GET /v1/requisitions`	List requisitions
`POST /v1/requisitions`	Create a requisition
`GET /v1/requisitions/{id}`	Get requisition details
`PATCH /v1/requisitions/{id}`	Update a requisition
`POST /v1/requisitions/{id}/close`	Close a requisition
`POST /v1/requisitions/{id}/open`	Open a requisition
`POST /v1/requisitions/{id}/approve`	Approve a requisition
`POST /v1/requisitions/{id}/reject`	Reject a requisition
`POST /v1/requisitions/{id}/submit`	Submit a requisition
`POST /v1/requisitions/{id}/reopen`	Reopen a requisition
`POST /v1/requisitions/{id}/archive`	Archive a requisition
`POST /v1/requisitions/{id}/approval_reminders`	Send a requisition approval reminder

Projects

Endpoint	Description
`GET /v1/projects`	List projects
`POST /v1/projects`	Create a project
`GET /v1/projects/{id}`	Get project details
`PATCH /v1/projects/{id}`	Update a project
`POST /v1/projects/{project_id}/candidates`	Add a candidate to a project
`GET /v1/projects/{project_id}/candidates`	List candidates in a project
`DELETE /v1/projects/{project_id}/candidates/{candidate_id}`	Remove a candidate from a project
`POST /v1/projects/{id}/archive`	Archive a project
`POST /v1/projects/{id}/clone`	Clone a project
`PATCH /v1/projects/{id}/collaborators`	Update a project's collaborators

Reviews

Endpoint	Description
`POST /v1/projects/{project_id}/reviews`	Send a candidate for review
`GET /v1/reviews`	List reviews
`GET /v1/reviews/{id}`	Get review details
`POST /v1/reviews/{id}/decision`	Record a review decision
`POST /v1/reviews/{id}/resend`	Resend a review request
`POST /v1/reviews/{id}/revoke`	Revoke a review request

Users

Endpoint	Description
`GET /v1/users`	List users
`GET /v1/users/{id}`	Retrieve a user
`POST /v1/users`	Create (invite) a user
`PATCH /v1/users/{id}`	Update a user
`POST /v1/users/{id}/deactivate`	Deactivate a user
`POST /v1/users/{id}/reactivate`	Reactivate a user

Roles

Endpoint	Description
`GET /v1/roles`	List roles
`GET /v1/roles/{id}`	Retrieve a role (with permissions)

Lookup Data

Endpoint	Description
`GET /v1/departments`	List departments
`GET /v1/offices`	List offices
`GET /v1/milestones`	List milestones
`GET /v1/candidate-sources`	List candidate sources
`GET /v1/custom-fields`	List custom fields
`GET /v1/rejection-reasons`	List rejection reasons
`GET /v1/close-reasons`	List close reasons
`GET /v1/application_form_templates`	List application form templates
`GET /v1/job_description_templates`	List job description templates
`GET /v1/employment_types`	List employment types
`GET /v1/job_profiles`	List job profiles
`GET /v1/locations`	Search cities, states, and countries
`GET /v1/companies`	Search companies
`GET /v1/industries`	List industries
`GET /v1/institutions`	Search academic institutions
`GET /v1/disciplines`	Search academic disciplines
`GET /v1/degrees`	List academic degrees
`GET /v1/tags`	Search tags
`GET /v1/skills`	Search skills
`GET /v1/currencies`	List currencies
`GET /v1/email_templates`	List email and calendar-invite templates

Webhooks

Endpoint	Description
`GET /v1/webhooks`	List webhooks
`POST /v1/webhooks`	Create a webhook
`GET /v1/webhooks/{id}`	Get webhook details
`PATCH /v1/webhooks/{id}`	Update a webhook
`DELETE /v1/webhooks/{id}`	Delete a webhook

Token Scope

Use a token with ats_api scope for this API. This scope provides full access and should only be used in secure server environments.

Security Best Practices

Store tokens in environment variables
Never expose tokens in client-side code
Use HTTPS for all API calls
Rotate tokens periodically
Monitor API usage for anomalies

Next Steps

Applications API Reference — Complete endpoint documentation
Webhooks Setup — Configure real-time notifications

Key Characteristics​

Use Cases​

Server-Side Example​

Available Endpoints​

Candidates​

Applications​

Interviews​

Scorecards​

Jobs​

Requisitions​

Projects​

Reviews​

Users​

Roles​

Lookup Data​

Webhooks​

Token Scope​

Security Best Practices​

Next Steps​