Update Customers

PUT

https://api.bigcommerce.com/stores/:store_hash/v3/customers

PUT

/stores/:store_hash/v3/customers

curl -X PUT https://api.bigcommerce.com/stores/store_hash/v3/customers \
     -H "X-Auth-Token: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '[
  {
    "id": 1
  }
]'

{
  "data": [
    {
      "email": "string",
      "first_name": "string",
      "last_name": "string",
      "company": "string",
      "phone": "string",
      "registration_ip_address": "string",
      "notes": "string",
      "tax_exempt_category": "string",
      "customer_group_id": 1,
      "id": 1,
      "date_modified": "2024-01-15T09:30:00Z",
      "date_created": "2024-01-15T09:30:00Z",
      "address_count": 1,
      "attribute_count": 1,
      "authentication": {
        "force_password_reset": true
      },
      "addresses": [
        {
          "first_name": "string",
          "last_name": "string",
          "address1": "string",
          "city": "string",
          "state_or_province": "string",
          "postal_code": "string",
          "country_code": "string",
          "customer_id": 1,
          "id": 1,
          "company": "string",
          "address2": "string",
          "phone": "string",
          "address_type": "residential",
          "country": "string",
          "form_fields": [
            {
              "name": "color",
              "value": "blue"
            }
          ]
        }
      ],
      "attributes": [
        {
          "attribute_id": 2,
          "attribute_value": "Yes",
          "customer_id": 1,
          "date_created": "2024-01-15T09:30:00Z",
          "date_modified": "2024-01-15T09:30:00Z",
          "id": 2
        }
      ],
      "form_fields": [
        {
          "name": "color",
          "value": "blue",
          "customer_id": 1
        }
      ],
      "store_credit_amounts": [
        {
          "amount": 43.15
        }
      ],
      "accepts_product_review_abandoned_cart_emails": true,
      "origin_channel_id": 1,
      "channel_ids": [
        null
      ]
    }
  ],
  "meta": {}
}

Updates Customers. Subresource updates are not supported.

Required Fields

id — ID of the Customer This must be included in the request body

Read Only Fields

id
registration_ip_address
date_created
date_modified
origin_channel_id

Limits

Limit of 10 customers per call.
Limit of 3 concurrent requests

Notes

Attributes Values can not be updated using Update a Customer. Use the Update customer attribute values endpoint.
channel_ids — Updating the list of channels a customer can access may create some side effects in a multi-storefront situation. This list determines which customer account we will use to authenticate a shopper given a channel.
origin_channel_id — This is an immutable value set as a reference to the channel of origin when a customer is created.

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.

Path parameters

store_hashstringRequired

Permanent ID of the BigCommerce store.

Request

This endpoint expects a list of objects.

idintegerRequired

The unique numeric ID of the customer.

emailstringOptional3-255 characters

The email of the customer. Must be unique.

first_namestringOptional1-100 characters

The first name of the customer.

last_namestringOptional1-100 characters

The last name of the customer.

companystringOptional0-255 characters

The company of the customer.

phonestringOptional0-50 characters

The phone number of the customer.

registration_ip_addressstringOptional0-30 characters

The IP address from which this customer was registered.

notesstringOptional

The customer notes.

tax_exempt_categorystringOptional0-255 characters

The tax exempt category code for the customer.

customer_group_idintegerOptional

ID of the group which this customer belongs to.

authenticationobjectOptional

accepts_product_review_abandoned_cart_emailsbooleanOptional

It determines if the customer is signed up to receive either product review or abandoned cart emails or receive both emails.

store_credit_amountslist of objectsOptional

Store credit.

origin_channel_idintegerOptional

Channel ID of the customer that has created the form.

channel_idslist of integersOptional

Arrays of channels the customer can access.

form_fieldslist of objectsOptional

Array of form fields. Controlled by formfields parameter.

Response

Customer Collection Response

datalist of objectsOptional

metaobjectOptional

Response metadata.

Errors

413

Content Too Large Error

422

Unprocessable Entity Error