---
title: "Submit Client Referral"
method: POST
path: "/api/client-referrals"
tags: ["client-referrals"]
---

# Submit Client Referral

`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

Submit a new client/company referral

Candidates and client users can submit referrals.

## Request body

- ClientReferralCreate: Submit a new client/company referral
  - `referred_company_name` string, required: Company name
  - `referred_contact_name` string, required: Decision maker name
  - `referred_contact_email` string, email, required: Contact email
  - `referred_contact_title` string, nullable: Job title
  - `referred_company_domain` string, 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_reason` string, nullable: Why they're a good fit
  - `specific_need` string, nullable: Current hiring pain/need

## Response `201`

Successful Response

- ClientReferralResponse: Client referral details
  - `id` string, required: Record ID
  - `referral_type` 'Client' | 'Candidate', required
  - `referrer_name` string, required: Name of person who referred
  - `referrer_company` string, nullable: Referrer's company (if client)
  - `referred_company_name` string, required
  - `referred_contact_name` string, required
  - `referred_contact_email` string, required
  - `referred_contact_title` string, nullable
  - `referred_company_domain` string, required
  - `referred_company_size` string, required
  - `referred_industry` string, required
  - `estimated_pricing_tier` string, required
  - `referral_reason` string, nullable
  - `specific_need` string, nullable
  - `status` string, required
  - `qualification_score` integer, required: Qualification score 0-100
  - `qualification_notes` string, nullable
  - `assigned_to` string, nullable
  - `demo_date` string, nullable
  - `signed_date` string, nullable
  - `lost_reason` string, nullable
  - `converted_company_id` string, nullable
  - `reward_tier` string, nullable
  - `reward_amount` number, nullable
  - `reward_status` string, required
  - `reward_paid_date` string, date-time, nullable
  - `reward_payment_id` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, nullable
  - `estimated_reward` string, required: Display text like '$2,000'
  - `status_history` object[]: Status change history
  - `auto_reward` object, nullable: Auto-reward result when status changed to Signed

## 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)