---
title: "Create Lead"
method: POST
path: "/v1/leads"
tags: ["leads"]
---

# Create Lead

`POST /v1/leads`

## Request

- Base URL: `https://api.wievielkostetmeinumzug.de` (the document declares no server; this is the origin it was published from)
- URL: `https://api.wievielkostetmeinumzug.de/v1/leads`
- Auth: none declared

Create a lead scoped to the brand resolved from X-Brand.

## Headers

- `X-API-Key` string, nullable
- `X-Brand` string, nullable

## Request body

- LeadCreateRequest: Request body for POST /v1/leads. brand_id is resolved server-side from X-Brand.
  - `from_city` string, nullable
  - `to_city` string, nullable
  - `total_m3` number, nullable
  - `move_date` string, date, nullable
  - `move_type` string, nullable
  - `budget_band` string, nullable
  - `languages` string[], nullable
  - `packing` boolean, nullable
  - `storage` boolean, nullable
  - `estimated_low_cents` integer, nullable
  - `estimated_high_cents` integer, nullable
  - `currency` string, nullable
  - `contact_name` string, nullable
  - `contact_email` string, nullable
  - `contact_phone` string, nullable
  - `consent` boolean
  - `source_url` string, nullable

## Response `201`

Successful Response

- Lead: Mirrors the `lead` table.
  - `id` string, uuid, required
  - `brand_id` integer, required
  - `from_city` string, nullable
  - `to_city` string, nullable
  - `total_m3` number, nullable
  - `move_date` string, date, nullable
  - `move_type` string, nullable
  - `budget_band` string, nullable
  - `languages` string[], nullable
  - `packing` boolean, nullable
  - `storage` boolean, nullable
  - `estimated_low_cents` integer, nullable
  - `estimated_high_cents` integer, nullable
  - `currency` string, nullable
  - `contact_name` string, nullable
  - `contact_email` string, nullable
  - `contact_phone` string, nullable
  - `routed_partner_ids` string[], nullable
  - `status` string
  - `consent` boolean
  - `source_url` string, nullable
  - `created_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/wievielkostetmeinumzug/apis/transport-hub-api.md) · [All operations](https://skmtc.dev/wievielkostetmeinumzug/apis/transport-hub-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wievielkostetmeinumzug/apis/transport-hub-api/revisions/b279e15073a5?raw)