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": "BQ7vLgHiKBGPjbYiRRhBJuoS",
  "type": "inline-assessment:order-received",
  "data": {
    "id": "B5KQKhAgTv6ZwzrfAbqbhipd",
    "integration_id": "workday:CBNMt7dSNCzBdnRTx87dev4E",
    "package_id": "typescript_test",
    "status": "OPEN",
    "candidate": {
      "email": "john.doe@gmail.com",
      "first_name": "John",
      "last_name": "Doe",
      "phone": "+1 123 456 7890",
      "remote_id": "26vafvWSRmbhNcxJYqjCzuJg"
    },
    "application": {
      "remote_id": "HAQ9uCfC1zi3TLbB1n5cyHgP"
    },
    "job": {
      "remote_id": "A1KQKhAgTv6ZwzrfAbqbhcde",
      "name": "Engineering Manager",
      "location": {
        "city": "San Francisco",
        "country": "United States"
      },
      "hiring_team": [
        {
          "first_name": "Jane",
          "last_name": "Doe",
          "remote_id": "26vafvWSRmbhNcxJYqjCzuJr",
          "email": "jane.doe@gmail.com",
          "hiring_team_roles": [
            "RECRUITER"
          ]
        }
      ]
    },
    "remote_data": {
      "upstream_webhook_body": {},
      "/assessment-orders": {}
    }
  }
}

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.