---
title: "Create a new lead"
method: POST
path: "/leads"
---

# Create a new lead

`POST /leads`

Create a new lead with the provided details. Requires a valid Bearer token.

## Request body

- object
  - `firstName` string, required — The first name of the lead
  - `lastName` string — The last name of the lead
  - `email` string, email — Email address of the lead
  - `phone` string — Phone number of the lead
  - `company` string — Company name of the lead
  - `title` string — Job title of the lead
  - `location` string — Location of the lead
  - `description` string — Additional details about the lead
  - `source` string — Source of the lead
  - `groupId` string
  - `stageId` string
  - `priorityId` string
  - `labelIds` string[]

## Response `201`

Lead created successfully

- object
  - `message` string
  - `leadId` string, uuid

## Other responses

- `401` — Unauthorized
- `500` — Error occurred while creating the lead

---

[API](https://skmtc.dev/supabase/apis/dalil-oauth-resource-api.md) · [All operations](https://skmtc.dev/supabase/apis/dalil-oauth-resource-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/supabase/dalil-oauth-resource-api/revisions/40a7125e0355/schema)