Application Delivery

Overview

Application Delivery sends every new application for your company to an HTTPS endpoint you operate. Use it when your ATS isn't one of Kini's integrations, or when you want applications to go straight into your own system.

As soon as a candidate applies, Kini sends one POST request containing the candidate's details, screening question answers, uploaded files (CV, cover letter, …) and the job they applied for.

Payload

{
  "application_id": 452123,
  "created_at": "2026-10-26T09:13:58Z",
  "channel": "indeed",
  "notes": "I can start on short notice.",
  "company_id": 123,
  "job_id": 12388996,
  "external_job_id": "REQ-1604",
  "job_title": "Warehouse Associate (m/f/d)",
  "candidate": {
    "email": "jane.doe@example.com",
    "first_name": "Jane",
    "last_name": "Doe",
    "gender": "FEMALE",
    "phone": "+49 170 1234567",
    "location": {
      "street": "Musterstraße 1",
      "postcode": "10115",
      "city": "Berlin",
      "country": "DE"
    }
  },
  "screening_questions": [
    {
      "id": "drivers_license",
      "question": "Do you have a driver's license?",
      "answer_type": "boolean",
      "answer": true
    },
    {
      "id": "shifts",
      "question": "Which shifts can you work?",
      "answer_type": "multiselect",
      "answer": ["early", "late"],
      "answer_label": ["Early shift", "Late shift"]
    },
    {
      "id": "motivation",
      "question": "Why do you want to work with us?",
      "answer_type": "textarea",
      "answer": "I enjoy working in a team and ..."
    }
  ],
  "attachments": [
    {
      "type": "cv",
      "name": "jane-doe-cv.pdf",
      "content_type": "application/pdf",
      "data": "JVBERi0xLjcKJcfsj6IKNSAwIG9iago8PC9MZW5ndGggNiAwIFI..."
    }
  ]
}

Missing values are sent as null and empty lists as [], so every key is always present. We may add fields over time, so ignore keys you don't recognize; existing fields won't be renamed or removed without notice.

Fields

The ID fields have the same names as in the Application Sync Status Update webhook.

candidate

screening_questions[]

attachments[]

Because files are embedded in the request, a single delivery can reach roughly 30 MB. Check that your endpoint, and any proxy or gateway in front of it, accepts bodies of that size.

Responding to deliveries

Kini waits up to 30 seconds for your response, then decides what happens next based on the HTTP status code you return:

To stay within the timeout, persist the payload and return 2xx immediately, then do heavier processing such as CV parsing asynchronously. Kini doesn't follow redirects, so configure the final URL.

Retries and duplicates

Temporary failures are retried with exponential backoff: after about 10, 30, 70 and 150 seconds, for 5 attempts over roughly 3 minutes. If the last attempt fails, the application's sync_status becomes FAILURE, which you can also receive through the Application Sync Status Update webhook. Contact tech@getkini.com to have failed applications redelivered.

Delivery is at least once. If your endpoint stores an application but doesn't respond within 30 seconds, Kini retries and you receive it again. application_id is stable across attempts, so use it to deduplicate and answer repeats with 2xx or 409.

Authentication

During setup, you provide a header name and secret value, for example Authorization: Bearer {token} or X-Api-Key: {key}. Kini stores the secret securely and sends the header with every request; reject requests without it. The endpoint must use HTTPS.

Setup

Application Delivery is configured per company. Send the following to tech@getkini.com:

• The HTTPS URL that should receive applications.
• The header name and secret value Kini should send with each request.
• Optionally, custom names for talent channels.

Before going live, we send a test application to your endpoint.