<- Object

Object

BulkUpsertMerchantCustomAttributesRequestMerchantCustomAttributeUpsertRequestBeta

An individual request contains a merchant ID, the custom attribute to create or update, and an optional idempotency key.

Link to section

Properties

Link to section

merchant_id

string

Required

Link to section

custom_attribute

Required

The custom attribute to create or update, with following fields:

  • key. This key must match the key of a custom attribute definition in the Square seller account. If the requesting application is not the definition owner, you must provide the qualified key.
  • value. This value must conform to the schema specified by the definition. For more information, see Supported data types.
  • The version field must match the current version of the custom attribute definition to enable optimistic concurrency If this is not important for your application, version can be set to -1. For any other values, the request fails with a BAD_REQUEST error.
Link to section

idempotency_key

string

A unique identifier for this individual upsert request, used to ensure idempotency. For more information, see Idempotency.