---
title: "Create Lead"
method: POST
path: "/api/v3/crm/{integration_id}/leads"
tags: ["CRM Leads"]
---

# Create Lead

`POST /api/v3/crm/{integration_id}/leads`

Create a new lead in the CRM.

**Required fields**:
- `lastname`: Lead's last name
- `company`: Company name

**Note**: This endpoint is only supported for Salesforce integrations.

## Path parameters

- `integration_id` string, uuid, required — The CRM integration ID

## Request body

- CreateLeadRequest — Request to create a lead in Salesforce. LastName and Company are required. All other fields are optional.
  - `LastName` string, required — Last name (required)
  - `Company` string, required — Company name (required)
  - `FirstName` string, nullable — First name
  - `Title` string, nullable — Job title
  - `Email` string, nullable — Email address
  - `Phone` string, nullable — Phone number
  - `MobilePhone` string, nullable — Mobile phone
  - `Website` string, nullable — Company website
  - `Street` string, nullable — Street address
  - `City` string, nullable — City
  - `State` string, nullable — State/province
  - `PostalCode` string, nullable — Postal code
  - `Country` string, nullable — Country
  - `Industry` string, nullable — Industry
  - `NumberOfEmployees` integer, nullable — Number of employees
  - `AnnualRevenue` number, nullable — Annual revenue
  - `Status` string, nullable — Lead status
  - `Rating` string, nullable — Lead rating
  - `LeadSource` string, nullable — Lead source
  - `Description` string, nullable — Description
  - `OwnerId` string, nullable — Owner user ID

## Response `200`

Successful Response

- LeadResponse — API response for a single lead.
  - `id` string, required
  - `properties` object, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/nationgraph/apis/nationgraph-api.md) · [All operations](https://skmtc.net/nationgraph/apis/nationgraph-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nationgraph/nationgraph-api/revisions/85804e68d86d/schema)