# Update a lead

> PATCH /leads/{id}. HeyRik API parameters and documented request and response examples.

Source: https://www.heyrik.com/docs/api-reference/crm/patch-leads-id-update-a-lead

PATCH https://server.heyrik.com/api/v1/leads/{id}

## Path parameters

- id (required): Replace {id} in the request URL with the value for this resource.

## Headers

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

## Parameters

- name / phone / email / company (string): Any of the core fields.
- stage (string): Moving stage here is recorded on the lead's timeline too.
- custom (object): Extra fields — become {{variables}} on a call.

## Request example

```sh
curl -X PATCH https://server.heyrik.com/api/v1/leads/lead_71a4 \
  -H "Authorization: Bearer $HEYRIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "company": "Acme Ltd", "custom": { "plan": "pro" } }'
```