<- Location Custom Attributes API

Location Custom Attributes API

Bulk upsert location custom attributesBeta

POST

 /v2/locations/custom-attributes/bulk-upsert

Creates or updates custom attributes for locations as a bulk operation.

Use this endpoint to set the value of one or more custom attributes for one or more locations. A custom attribute is based on a custom attribute definition in a Square seller account, which is created using the CreateLocationCustomAttributeDefinition endpoint. This BulkUpsertLocationCustomAttributes endpoint accepts a map of 1 to 25 individual upsert requests and returns a map of individual upsert responses. Each upsert request has a unique ID and provides a location ID and custom attribute. Each upsert response is returned with the ID of the corresponding request. To create or update a custom attribute owned by another application, the visibility setting must be VISIBILITY_READ_WRITE_VALUES.

Permissions:MERCHANT_PROFILE_WRITE

Guide

Bulk upsert location custom attributes

Try in API Explorer
Link to section

Request body

Example code

Link to section

values

Required

A map containing 1 to 25 individual upsert requests. For each request, provide an arbitrary ID that is unique for this BulkUpsertLocationCustomAttributes request and the information needed to create or update a custom attribute.

Show attributes
Link to section

Response fields

Link to section

values

A map of responses that correspond to individual upsert requests. Each response has the same ID as the corresponding request and contains either a location_id and custom_attribute or an errors field.

Show attributes
Link to section

errors

Any errors that occurred during the request.

Show attributes