Error Handling

await fetch('https://api.kombo.dev/v1/ats/candidates', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <API_KEY>',
    'Content-Type': 'application/json',
    'X-Integration-Id': '<INTEGRATION_ID>',
  },
  body: JSON.stringify({
    // the body content is missing
  })
})

{
  "status": "error",
  "error": {
    "code": "PLATFORM.INPUT_INVALID",
    "title": "Your request contains invalid data and failed validation.",
    "message": "candidate: Required; application: Required",
    "log_url": "https://app.kombo.dev/my-prod/logs?interactionId=123456"
  }
}

{
  "status": "error",
  "error": {
    "code": "ATS.APPLICATION_ALREADY_EXISTS",
    "title": "Candidate has already applied to this job.",
    "message": "John Doe (john@example.com) has an existing application for Software Engineer position",
    // ...
  }
}

// ...call to create application...

const body = await response.json()
if (body.error.code === "ATS.APPLICATION_ALREADY_EXISTS") {
  showInfo("You've already applied to this position.")
  return
}

throw new Error("Application failed")

{
  "status": "error",
  "error": {
    "code": "REMOTE.SERVICE_UNAVAILABLE",
    "title": "The remote system is currently unavailable.",
    "message": "The API of \"Workday\" is currently unavailable. Please try again later.",
    "log_url": "https://app.kombo.dev/my-prod/logs?interactionId=123456"
  }
}

{
  "status": "error",
  "error": {
    "code": "REMOTE.INPUT_INVALID",
    "title": "The remote system returned validation errors.",
    "message": "Employee field 'department' is required for BambooHR",
    "log_url": null
  }
}

{
  "status": "error",
  "error": {
    "code": "REMOTE.INPUT_INVALID",
    "title": "The remote system returned validation errors.",
    "message": "Candidate field 'email' must be a valid email address for Greenhouse",
    "log_url": null
  }
}