---
title: "Adds a referee to an existing candidate"
method: POST
path: "/Entity/Referee"
tags: ["Entity"]
---

# Adds a referee to an existing candidate

`POST /Entity/Referee`

The Referee's Surname and RefereeType value must be passed.
            
Company and JobTitle are not supported if the RefereeType is InCaseOfEmergencyContact
            
Although Checked is optional, if set to true then the CheckedDate must also be passed.

## Request body

- RefereeRequest
  - `CandidateId` integer, required
  - `RefereeType` 'InCaseOfEmergencyContact' | 'PersonalReference' | 'EmployerReference' | 'AcademicReference' | 'VoluntaryReference', required
  - `TitleId` integer, nullable
  - `Forename` string, nullable
  - `Surname` string, required
  - `Relationship` string, nullable
  - `Company` string, nullable
  - `JobTitle` string, nullable
  - `AddressLine1` string, nullable
  - `AddressLine2` string, nullable
  - `AddressLine3` string, nullable
  - `Town` string, nullable
  - `County` string, nullable
  - `Postcode` string, nullable
  - `CountryId` integer, nullable
  - `Mobile` string, nullable
  - `Landline` string, nullable
  - `Email` string, nullable
  - `Notes` string, nullable
  - `Checked` boolean
  - `CheckedDate` string, date-time, nullable

## Response `200`

OK - Created ID

- integer

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `404` — NotFound

---

[API](https://skmtc.dev/vslcloud/apis/infinity-api.md) · [All operations](https://skmtc.dev/vslcloud/apis/infinity-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vslcloud/infinity-api/revisions/54661781612a/schema)