Upsert Customer Attribute Values
Upserts Customer Attribute Values. Updates the attribute values on the Customer. Multiple customer attribute values can be updated in one call.
Upsert checks for an existing record. If there is none, it creates the record, if there is a matching record, it updates that record.
**Limits**
* Limit of 10 customers per call.
* Limit of 3 concurrent requests.
Authentication
X-Auth-Tokenstring
### OAuth scopes
| UI Name | Permission | Parameter |
|:--------|:-----------|:----------|
| Customers | modify | `store_v2_customers` |
| Customers | read-only | `store_v2_customers_read_only` |
| Stored Payment Instruments | modify | `store_stored_payment_instruments` |
| Stored Payment Instruments | read-only | `store_stored_payment_instruments_read_only` |
### Authentication header
| Header | Argument | Description |
|:-------|:---------|:------------|
| `X-Auth-Token` | `access_token` | For more about API accounts that generate `access_token`s, see our [Guide to API Accounts](/developer/docs/overview/api-accounts#api-accounts). |
### Further reading
For example requests and more information about authenticating BigCommerce APIs, see [Authentication and Example Requests](/developer/docs/overview/api-accounts#x-auth-token-header-example-requests).
For more about BigCommerce OAuth scopes, see our [Guide to API Accounts](/developer/docs/overview/api-accounts#oauth-scopes).
For a list of API status codes, see [API Status Codes](/developer/api-reference/rest/overview#rest-http-status-codes).
Headers
Accept
Request
attribute_id
Attribute ID.
value
Attribute value. This will always be a string, regardless of the attributeʼs type.
Corresponds to attribute_value used in customer attribute values GET requests.
customer_id
Customer ID.
id
Attribute value ID.
Response
data
meta
Data about the response, including pagination and collection totals.
Errors
422
Unprocessable Entity Error
