client-referrals

Submit Client Referral

Submit a new client/company referral

Candidates and client users can submit referrals.

post/api/client-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/client-referrals
  • Auth: HTTP bearer

Request body

referred_company_namestring required

Company name

referred_contact_namestring required

Decision maker name

referred_contact_emailstring email required

Contact email

referred_contact_titlestring nullable

Job title

referred_company_domainstring required

Company domain (e.g., acme.com)

referred_company_size'1-50' | '51-200' | '201-500' | '500+' required

Estimated company size

referred_industry'SaaS' | 'FinTech' | 'AI/ML' | 'E-commerce' | 'Other' required

Industry

estimated_pricing_tier'Pilot' | 'Growth' | 'Squad' required

Projected pricing tier

referral_reasonstring nullable

Why they're a good fit

specific_needstring nullable

Current hiring pain/need

Response

Successful Response

idstring required

Record ID

referral_type'Client' | 'Candidate' required
referrer_namestring required

Name of person who referred

referrer_companystring nullable

Referrer's company (if client)

referred_company_namestring required
referred_contact_namestring required
referred_contact_emailstring required
referred_contact_titlestring nullable
referred_company_domainstring required
referred_company_sizestring required
referred_industrystring required
estimated_pricing_tierstring required
referral_reasonstring nullable
specific_needstring nullable
statusstring required
qualification_scoreinteger required

Qualification score 0-100

qualification_notesstring nullable
assigned_tostring nullable
demo_datestring nullable
signed_datestring nullable
lost_reasonstring nullable
converted_company_idstring nullable
reward_tierstring nullable
reward_amountnumber nullable
reward_statusstring required
reward_paid_datestring date-time nullable
reward_payment_idstring nullable
created_atstring date-time required
updated_atstring date-time nullable
estimated_rewardstring required

Display text like '$2,000'

status_historyobject[]

Status change history

auto_rewardobject nullable

Auto-reward result when status changed to Signed

Changes

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