Inline Assessment - Kombo

In an inline assessment flow, the candidate will be assessed immediately after applying to a job via a career page. The ATS expects a URL to your platform so that the candidate can be redirected to your product to take the test.

Reacting to new inline assessment orders

Unlike the default assessment flow, we will send out an inline-assessment:order-received webhook when we receive an order. The webhook will contain the following payload:

inline-assessment:order-received

{
  "id": "8KNLzKfRXjJ3Xjfaz5FkgdPA",
  "type": "inline-assessment:order-received",
  "data": {
    "id": "B5KQKhAgTv6ZwzrfAbqbhipd",
    "integration_id": "workday:CBNMt7dSNCzBdnRTx87dev4E",
    "package_id": "typescript_test",
    "status": "OPEN",
    "candidate": {
      "remote_id": "12345",
      "email": "john.doe@gmail.com",
      "first_name": "John",
      "last_name": "Doe",
      "phone": "+1 123 456 7890"
    },
    "application": {
      "remote_id": "54321"
    },
    "job": {
      "remote_id": "67890",
      "name": "Bottle Opener",
      "job_code": "BO-2024-01",
      "description": "<p>We are looking for a skilled and energetic individual to join our team as the chief bottle open officer. This unique role requires precision, attention to detail, and the ability to handle a high volume of beverage bottles in a fast-paced environment. The ideal candidate will ensure bottles are opened swiftly and safely while maintaining hygiene standards.</p>",
      "location": {
        "street_1": "Lohmühlenstraße 65",
        "city": "Berlin",
        "state": "Berlin",
        "zip_code": "12435",
        "country": "DE",
        "raw": "Berlin, Germany"
      },
      "hiring_team": [
        {
          "first_name": "Jane",
          "last_name": "Doe",
          "remote_id": "78901",
          "email": "jane.doe@gmail.com",
          "hiring_team_roles": ["RECRUITER"]
        }
      ]
    }
  }
}

It is required that you respond with a body that contains a link to your platform where the candidate will be assessed:

{
  "assessment_url": "https://app.acme.com/assessment/:test_id"
}

Most ATSs will terminate their request for an assessment after 15 to 30 seconds, this means you should respond to us as soon as possible to ensure the order is created successfully.