Creates or updates a custom attribute for a customer profile.
POST
/v2/customers/{customer_id}/custom-attributes/{key}
Creates or updates a custom attribute for a customer profile.
Use this endpoint to set the value of a custom attribute for a specified customer profile. A custom attribute is based on a custom attribute definition in a Square seller account, which is created using the CreateCustomerCustomAttributeDefinition endpoint.
To create or update a custom attribute owned by another application, the visibility
setting must be VISIBILITY_READ_WRITE_VALUES
. Note that seller-defined custom attributes (also known as custom fields) are always set to VISIBILITY_READ_WRITE_VALUES
.
The ID of the target customer profile.
The custom attribute to create or update, with the following fields:
value
. This value must conform to the schema
specified by the definition. For more information, see Value data types.
version
. To enable optimistic concurrency control for an update operation, include this optional field and specify the current version of the custom attribute.
A unique identifier for this request, used to ensure idempotency. For more information, see Idempotency.