---
title: "Add Candidate To Job Role"
method: POST
path: "/api/job-roles/{job_role_id}/candidates"
tags: ["Job Roles"]
---

# Add Candidate To Job Role

`POST /api/job-roles/{job_role_id}/candidates`

## Request

- Base URL: `https://api.thebetterhire.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.thebetterhire.ai/api/job-roles/{job_role_id}/candidates`
- Auth: HTTP bearer

Add a candidate to a job role (without scheduling an interview)

Supports two modes:
1. Link existing candidate: Provide candidate_id
2. Create new candidate: Provide name, email, and optionally phone, source, notes

Optionally include a resume_file which will be stored on the candidate record.

## Path parameters

- `job_role_id` string, uuid, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api.md) · [All operations](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/revisions/c8ad03e900ea?raw)