---
title: "Create Placement"
method: POST
path: "/api/placements"
tags: ["placements"]
---

# Create Placement

`POST /api/placements`

## 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/placements`
- Auth: HTTP bearer

Create a new placement (founder only)

Sets status to "Proposed" by default

## Request body

- PlacementCreate: Request model for creating a placement
  - `client_id` string, required: Company record ID
  - `candidate_id` string, required: Candidate record ID
  - `role_type` string, required: Job role/title
  - `monthly_rate` integer, required: Monthly rate in USD (minimum $1,000)
  - `pricing_tier` 'Pilot' | 'Growth' | 'Squad', nullable: Auto-inherited from company if not provided
  - `start_date` string, date, nullable: Candidate start date
  - `contractor_monthly_cost` integer, nullable: Monthly contractor pay in USD

## Response `201`

Successful Response

- PlacementResponse: Response model for placement data
  - `id` string, required
  - `client` object, nullable
  - `candidate` object, nullable
  - `role_type` string, required
  - `monthly_rate` integer, required
  - `pricing_tier` string, nullable
  - `start_date` string, date, nullable
  - `end_date` string, date, nullable
  - `status` string, required
  - `proposal_url` string, nullable
  - `signed_date` string, date, nullable
  - `first_invoice_paid` boolean
  - `churn_reason` string, nullable
  - `nps_score` integer, nullable
  - `duration_days` integer, nullable
  - `contractor_monthly_cost` integer, nullable
  - `deel_contract_id` string, nullable
  - `payment_provider` string, nullable
  - `gross_margin_dollars` integer, nullable
  - `margin_percent` number, nullable
  - `created_at` string, date-time, required

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