# PUT /api/leads/{id}

> Leads - Update a Lead

- **Endpoint:** `PUT /api/leads/{id}`
- **Group:** Leads
- **Since:** v1.0.0
- **Defined in:** `RestApi/Controllers/LeadsController.php`

## Headers

| Field | Type | Description |
| --- | --- | --- |
| `authtoken` | String | Authentication token, generated from admin area |

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | Number | yes | lead unique ID. |
| `company_name` | string | yes | Mandatory Lead Name. |
| `owner_id` | string | yes | Mandatory Lead owner id |
| `lead_status_id` | string | yes | Mandatory Lead status id |
| `lead_source_id` | string | yes | Mandatory Lead source id |
| `address` | string | yes | Optional Lead address |
| `city` | string | yes | Optional Lead city |
| `state` | string | yes | Optional Lead state |
| `zip` | string | yes | Optional Lead zip |
| `country` | string | yes | Optional Lead country |
| `phone` | string | yes | Optional Lead phone |
| `website` | string | yes | Optional Lead website |
| `vat_number` | string | yes | Optional Lead vat number |

## Request example

```bash
curl -X PUT "https://yoursite.com/index.php/api/leads/123" \
  -H "authtoken: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "company_name": "...", "owner_id": "...", "lead_status_id": "...", "lead_source_id": "...", "address": "...", "city": "...", "state": "...", "zip": "...", "country": "...", "phone": "...", "website": "...", "vat_number": "..." }'
```

## Responses

### Success - Success-Response:

```json
HTTP/1.1 200 OK
{
  "status": true,
  "message": "Lead Update Successful."
}


HTTP/1.1 404 Not Found
{
  "status": false,
  "message": "Lead Update Fail."
}
```

---

Part of the [REST API for RISE CRM](https://risecrm.themesic.com/apiguide/) documentation.
Full page: https://risecrm.themesic.com/apiguide/leads/update-lead/