---
title: "Submit a lead"
method: POST
path: "/v1/lead-submissions"
tags: ["v1"]
---

# Submit a lead

`POST /v1/lead-submissions`

## Request

- Base URL: `https://app.eve.legal` (the document declares no server; this is the origin it was published from)
- URL: `https://app.eve.legal/v1/lead-submissions`
- Auth: none declared. Required headers: `X-API-Key`

Submit a lead in any shape. Recommended fast-path keys: name (or first_name + last_name), phone, email. All other keys are preserved on the lead and feed overview generation. Bodies must be UTF-8 encoded. Payloads with no data at all (empty body, empty object, or a form whose fields are all blank) are rejected with 400 empty_payload; anything else is accepted, with warnings flagging missing standard fields. Requires a per-integration API key in X-API-Key. Bodies are capped at 1 MB and requests are rate-limited per integration. A 202 means the lead was durably stored; senders should retry on 5xx responses and on timeouts or connection failures where no response was received.

## Headers

- `X-API-Key` string, required

## Response `202`

Successful Response

- LeadSubmissionResponseDto
  - `submissionId` string, uuid, required: ID of the stored submission
  - `status` 'received': Always 'received' on 202
  - `warnings` LeadSubmissionWarning[]: Standard-key presence warnings. The lead is created either way; AI extraction may still recover missing fields.
    - `code` 'missing_name' | 'missing_phone' | 'missing_email' | 'unrecognized_shape', required
    - `message` string, required: Human-readable explanation for the sender

## Other responses

- `400`: Empty payload — the body contains no non-empty fields to build a lead from
- `401`: Missing, invalid, or revoked API key
- `413`: Body exceeds the 1 MB cap
- `422`: Validation Error
- `429`: Rate limit exceeded; Retry-After indicates when to resume

---

[API](https://skmtc.dev/eve/apis/eve-public-api.md) - [All operations](https://skmtc.dev/eve/apis/eve-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/eve/apis/eve-public-api/revisions/1a108b551ef3?raw)