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

# Phone

> Use phone attributes in the Breakcold API.

## Attribute type

`phone`

## Use it for

Phone numbers for people or companies.

## Request value

Send a string, or an object like `{ "value": "+15550100", "label": "Mobile", "countryCode": "US", "isPrimary": true }`. For multi-value phone attributes, send an array.

```json theme={null}
{
  "fields": {
    "phone": "+15550100"
  }
}
```

## Returned shape

Returns `{ "value", "label", "countryCode", "isPrimary" }`. Multi-value phone attributes return an array of those objects.

## Example response

```json theme={null}
{
  "fields": {
    "phone": {
      "value": "+15550100",
      "label": "Mobile",
      "countryCode": "US",
      "isPrimary": true
    }
  }
}
```

## Multiple values

For a multi-value phone attribute, send an array of strings or phone objects.

```json theme={null}
{
  "fields": {
    "phone": [
      "+15550100",
      {
        "value": "+15550101",
        "label": "Office",
        "countryCode": "US",
        "isPrimary": false
      }
    ]
  }
}
```

Returns an array of `{ "value", "label", "countryCode", "isPrimary" }` objects.

```json theme={null}
{
  "fields": {
    "phone": [
      {
        "value": "+15550100",
        "label": "Mobile",
        "countryCode": "US",
        "isPrimary": true
      },
      {
        "value": "+15550101",
        "label": "Office",
        "countryCode": "US",
        "isPrimary": false
      }
    ]
  }
}
```