---
title: "Convert Referral To Candidate"
method: POST
path: "/api/candidate-referrals/{referral_id}/convert"
tags: ["candidate-referrals"]
---

# Convert Referral To Candidate

`POST /api/candidate-referrals/{referral_id}/convert`

## Request

- Base URL: `https://api.ruzora.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ruzora.com/api/candidate-referrals/{referral_id}/convert`
- Auth: HTTP bearer

Convert referral to candidate record (founder only)

## Path parameters

- `referral_id` string, required

## Request body

- ConvertReferralRequest: Request to convert referral to candidate
  - `referral_id` string, required: Candidate referral ID to convert
  - `additional_notes` string, nullable: Additional notes for candidate record

## Response `200`

Successful Response

- ConvertReferralResponse: Response after converting referral to candidate
  - `referral_id` string, required
  - `candidate_id` string, required
  - `candidate_name` string, required
  - `overall_score` integer, required: Candidate score from scoring service
  - `status` string, required: New referral status
  - `message` string, required: Confirmation message

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api.md) · [All operations](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api/revisions/f9b8223f3ac4?raw)