FileMaster

Edit File: bulk-update-customers-request.md

# Bulk Update Customers Request

Defines the body parameters that can be included in requests to the
[BulkUpdateCustomers](../../doc/apis/customers.md#bulk-update-customers) endpoint.

## Structure

`BulkUpdateCustomersRequest`

## Fields

| Name | Type | Tags | Description | Getter | Setter |
| --- | --- | --- | --- | --- | --- |
| `customers` | [`array<string,BulkUpdateCustomerData>`](../../doc/models/bulk-update-customer-data.md) | Required | A map of 1 to 100 individual update requests, represented by `customer ID: { customer data }` key-value pairs. Each key is the ID of the [customer profile](entity:Customer) to update. To update a customer profile that was created by merging existing profiles, provide the ID of the newly created profile. Each value contains the updated customer data. Only new or changed fields are required. To add or update a field, specify the new value. To remove a field, specify `null`. | getCustomers(): array | setCustomers(array customers): void |

## Example (as JSON)

```json
{
  "customers": {
    "8DDA5NZVBZFGAX0V3HPF81HHE0": {
      "email_address": "New.Amelia.Earhart@example.com",
      "note": "updated customer note",
      "phone_number": null,
      "version": 2,
      "given_name": "given_name4",
      "family_name": "family_name6",
      "company_name": "company_name8",
      "nickname": "nickname8"
    },
    "N18CPRVXR5214XPBBA6BZQWF3C": {
      "family_name": "Curie",
      "given_name": "Marie",
      "version": 0,
      "company_name": "company_name8",
      "nickname": "nickname8",
      "email_address": "email_address0"
    }
  }
}
```

Back