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

#  How to use Custom Attributes

> Learn how to effectively use custom attributes in Breakcold to enhance your workflows.

## 1. Get the Field ID You Want to Update

To update a custom attribute, you first need its Field ID. Here’s how to find it:

1. Navigate to [**Person**](https://app.breakcold.com/settings/data/person) or [**Company Settings**](https://app.breakcold.com/settings/data/company) in your Breakcold workspace settings
2. Locate the field you want to update.
3. Click on the three dots next to the field and select **Copy attribute ID**.

### Special Note for `Select`, `MultiSelect`, `Location`,`Date`, or `Relation` Attribute Types

Custom attributes can have special behaviors depending on their types. Here are some key points to remember:

* **`Select`, `MultiSelect` Attributes**:
  The value can be a single option ID or an array of option IDs. The backend will handle the conversion automatically.

* **`Location` Attributes**:
  The value should be an object with the following properties:
  ```json theme={null}
  {
    "latitude": 48.8566,
    "longitude": 2.3522,
    "address": "Paris, France"
  }
  ```

* **`Date` Attributes**:
  The value must be in ISO 8601 format.

* **`Relation` Attributes**:
  The value must be the ID of the related lead.

***

## 2. Create or Update a Lead with Custom Attributes

When [creating](/v3/api-reference/leads/create-a-lead) or [updating](/v3/api-reference/leads/update-a-lead) a lead, include the attributes you want to modify in the **body** of the API request. Here's an example:

```json theme={null}
{
  "attributes": {
    "company-size": 500,
    "last-contact-date": "2023-05-10T14:30:00Z",
    "is-qualified": true,
    "industry": "option-id-tech",
    "date": "2023-05-10T14:30:00Z",
    "interests": ["option-id-ai", "option-id-cloud"],
    "location": {
      "latitude": 48.8566,
      "longitude": 2.3522,
      "address": "Paris, France"
    },
    "related-lead": "lead-id-12345",
    "notes": "Interested in our enterprise solution"
  }
}
```

### Important Notes:

* Ensure that all **`Select`** or **`MultiSelect`** attribute values are valid IDs. Incorrect or unrecognized IDs will result in an error.

* **`Location` Attributes**:
  The backend expects latitude, longitude, and address values to be present in the object.

* **`Relation` Attributes**:
  The value must be the ID of the related lead.

* **`Date` Attributes**:
  The value must be in ISO 8601 format.

For more details on request structure and available endpoints, refer to the [API Reference](#).

***

### Error Handling

* Unrecognized IDs or invalid values for `Select`, `Relation` or `MultiSelect` attributes will return an error.
* Ensure proper data structure for `Location` attributes.

For more details on request structure and available endpoints, refer to the [API Reference](/v3/api-reference/).

***

## 3. You're Done! 🎉

Congratulations! You’ve successfully used custom attributes in Breakcold.

If you encounter any errors, double-check your Field IDs and values, especially for **Select**, **Location**, and **Relation** attributes.