# Create a lead

> POST /leads. HeyRik API parameters and documented request and response examples.

Source: https://www.heyrik.com/docs/api-reference/crm/post-leads-create-a-lead

POST https://server.heyrik.com/api/v1/leads

## Headers

Authorization: Bearer $HEYRIK_API_KEY (required). Keep your key on your server.

## Parameters

- name (string, required): Contact name.
- phone (string): E.164 — required if you want to call them.
- email (string): Contact email.
- company (string): Company name.
- stage (string): Pipeline stage. Defaults to the first stage.
- custom (object): Any extra fields — become {{variables}} on a call.

## Request example

```sh
curl -X POST https://server.heyrik.com/api/v1/leads \
  -H "Authorization: Bearer $HEYRIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ravi Kumar",
    "phone": "+919876543210",
    "company": "Acme",
    "stage": "new",
    "custom": { "order_id": "AC-8842" }
  }'
```