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

# POST /leads

`POST /leads`

## Request body

- union — Phase 140-03: Store lead via Public API. Either `customer_id` (prefixed id of an existing customer) OR `name` (flat Zapier-style payload with optional email/phone) must be supplied.
  - object
    - `customer_id` string, nullable, required
    - `name` string, nullable
    - `email` string, email, nullable
    - `phone` string, nullable
    - `event_date` string, date-time, nullable
    - `event_type` string, nullable
    - `source` string, nullable
    - `status` string, nullable
    - `notes` string, nullable
    - `metadata` string[], nullable
  - object
    - `customer_id` string, nullable
    - `name` string, nullable, required
    - `email` string, email, nullable
    - `phone` string, nullable
    - `event_date` string, date-time, nullable
    - `event_type` string, nullable
    - `source` string, nullable
    - `status` string, nullable
    - `notes` string, nullable
    - `metadata` string[], nullable

## Response `201`

`LeadResource`

- union
  - string
  - object
    - `data` LeadResource, required
      - `id` integer, required
      - `name` string, nullable, required
      - `email` string, nullable, required
      - `phone` string, nullable, required
      - `event_date` string, required
      - `event_type` string, nullable, required
      - `source` string, nullable, required
      - `notes` string, nullable, required
      - `status` string, required
      - `created_at` string, required

## Other responses

- `422` — Validation error

---

[API](https://skmtc.dev/boothzen/apis/boothzen-api-v1.md) · [All operations](https://skmtc.dev/boothzen/apis/boothzen-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/boothzen/boothzen-api-v1/revisions/a5ae040e3ba3/schema)