# Create referee

Creates a referee on a Reference Check Plus.

Endpoint: POST /candidates/{partner_application_id}/checks/{candidate_check_id}/referees
Version: 1.0.0
Security: bearerAuth

## Path parameters:

  - `partner_application_id` (string, required)
    value of candidate.partner_application_id

  - `candidate_check_id` (integer, required)

## Request fields (application/json):

  - `candidate_form_id` (integer, required)
    Form ID for Candidate
    Example: 12

  - `form_id` (integer, required)
    Form ID for Referee
    Example: 24

  - `manual` (boolean)
    If true, details are provided on this call; communications to candidate won't be sent

  - `answers` (object)
    Keys are form field IDs, values are answers

## Response 200 fields (application/json):

  - `result` (object)

  - `result.id` (integer)
    Example: 6153

  - `result.first_name` (string)
    Example: "Jar Jar"

  - `result.last_name` (string)
    Example: "Binks"

  - `result.name` (string)
    Example: "Jar Jar Binks"

  - `result.email` (string)
    Example: "jarjar.binks@gmail.com"

  - `result.contact_number` (string)
    Example: "+123456789"

  - `result.created_at` (string)
    Example: "2025-08-15T20:38:03+00:00"

  - `result.submitted_at` (string,null)
    Example: "2025-08-15T20:38:03+00:00"

  - `result.completed_at` (string,null)

  - `result.ip` (string,null)

  - `result.linkedin_profile` (string,null)

  - `result.backup` (boolean)

  - `result.overdue` (boolean)

  - `result.replaced_by` (integer,null)
    Example: 2

  - `result.manual` (boolean)
    Example: true

  - `result.canceled` (boolean)

  - `result.user_agent` (string,null)

  - `result.ip_country` (string,null)

  - `result.candidate_form_id` (integer)
    Example: 896

  - `result.form_id` (integer)
    Example: 891

  - `result.warning_flag` (boolean)

  - `result.approved_by_client` (boolean)

  - `result.status` (string)
    Enum: "canceled", "completed", "overdue", "in-progress", "candidate"

  - `error` (object,null)