---
title: "Handle Shortlist Request"
method: POST
path: "/api/forms/shortlist-request"
tags: ["Forms"]
---

# Handle Shortlist Request

`POST /api/forms/shortlist-request`

## 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/forms/shortlist-request`
- Auth: none declared

Shortlist intake. For our MCP (C4a, funnel-wave PRD §1.4 tier c) a
verified buyer token is checked first (``buyer_verification.enforce``:
BUYER_VERIFICATION_REQUIRED, or any token that was sent); a verified
request then lands in the Sol App as a role + a "ready in Sol" email.
Every other caller (website, Sol) runs exactly as before.

## Request body

- ShortlistRequestCreate: Shortlist request from /request-shortlist (P0 staff aug intake).
  - `utm_source` string, nullable
  - `utm_medium` string, nullable
  - `utm_campaign` string, nullable
  - `utm_content` string, nullable
  - `utm_term` string, nullable
  - `referrer_url` string, nullable
  - `landing_page` string, nullable
  - `first_touch_landing_page` string, nullable
  - `full_name` string, required
  - `work_email` string, email, required
  - `company` string, required
  - `role` string, required
  - `seniority` string, required
  - `skills` string
  - `engineers` integer
  - `timeline` string
  - `notes` string
  - `referrer_origin` string, nullable
  - `session_id` string, nullable
  - `required_skills` string[]
  - `preferred_skills` string[]
  - `role_slug` string, nullable

## Response `200`

Successful Response

- unknown

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