candidate-referrals

Submit Candidate Referral

Submit a new candidate referral

Candidates and client users can submit referrals. Automatically calculates quality score and checks for duplicates.

post/api/candidate-referrals

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
  • Auth: HTTP bearer

Request body

referred_namestring required

Full name of referred person

referred_emailstring email required

Email of referred person

referred_linkedin_urlstring nullable

LinkedIn profile URL

referred_github_urlstring nullable

GitHub profile URL

referred_skillsstring nullable

Comma-separated skills

referred_locationstring nullable

Country/city location

referral_reasonstring nullable

Why they're a good fit

relationship'Former Colleague' | 'Friend' | 'Mentor/Mentee' | 'Other' required

Relationship with referred person

current_rolestring nullable

Current job title

current_companystring nullable

Current employer

Response

Successful Response

idstring required

Record ID

referrer_typestring required
referrer_emailstring required
referred_namestring required
referred_emailstring required
referred_linkedin_urlstring nullable
referred_github_urlstring nullable
referred_skillsstring nullable
referred_locationstring nullable
referral_reasonstring nullable
relationshipstring nullable
current_rolestring nullable
current_companystring nullable
statusstring required
quality_scoreinteger required

Quality score 0-100

duplicate_of_candidate_idstring nullable
created_candidate_idstring nullable
matched_placement_idstring nullable
reward_statusstring required
reward_amountnumber nullable
reward_paid_datestring date-time nullable
conversion_datestring date-time nullable
created_atstring date-time required
estimated_rewardstring required

Display text like '$500' or '10% off invoice'

status_historyobject[]

Status change audit trail

auto_rewardobject nullable

Auto-reward result if triggered

Changes

No recorded changes to this operation across all 1 revision of this API.