> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leavo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Field Values

> Manage custom field values for leads

## Get Lead Values

<Card>
  <strong>GET</strong> `/backend/lead-fields/{lead_id}`
</Card>

### Response

```json theme={null}
{
  "success": true,
  "data": [
    {
      "field_id": "field-uuid-1",
      "field_name": "Lead Source",
      "field_key": "lead_source",
      "value": "Website"
    },
    {
      "field_id": "field-uuid-2",
      "field_name": "Interest",
      "field_key": "interest",
      "value": "Product A"
    }
  ]
}
```

***

## Set Value

<Card>
  <strong>PUT</strong> `/backend/lead-fields/{lead_id}/{field_id}`
</Card>

### Body Parameters

<ParamField body="value" type="any" required>
  Value to set (type must match field definition)
</ParamField>

### Request Example

```bash theme={null}
curl -X PUT "https://api.leavo.ai/backend/lead-fields/lead-uuid/field-uuid" \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "value": "Referral"
  }'
```

### Response

```json theme={null}
{
  "success": true,
  "data": {
    "field_id": "field-uuid",
    "lead_id": "lead-uuid",
    "value": "Referral",
    "updated_at": "2024-01-15T14:00:00Z"
  }
}
```

***

## Set Multiple Values

<Card>
  <strong>PUT</strong> `/backend/lead-fields/{lead_id}`
</Card>

### Body Parameters

<ParamField body="fields" type="object" required>
  Object with field\_key: value pairs
</ParamField>

### Request Example

```bash theme={null}
curl -X PUT "https://api.leavo.ai/backend/lead-fields/lead-uuid" \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "fields": {
      "lead_source": "Referral",
      "interest": "Product B",
      "budget": 50000
    }
  }'
```