<- Location Custom Attributes API

Location Custom Attributes API

Upsert location custom attributeBeta

POST

 /v2/locations/{location_id}/custom-attributes/{key}

Creates or updates a custom attribute for a location.

Use this endpoint to set the value of a custom attribute for a specified location. A custom attribute is based on a custom attribute definition in a Square seller account, which is created using the CreateLocationCustomAttributeDefinition endpoint. 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

Upsert location custom attribute

Try in API Explorer
Link to section

Path parameters

Example code

Link to section

location_id

string

Required

The ID of the target location.

Link to section

key

string

Required

The key of the custom attribute to create or update. 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 use the qualified key.

Link to section

Request body

Link to section

custom_attribute

Required

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 Supported data types.
  • version. To enable optimistic concurrency control for an update operation, include the current version of the custom attribute. If this is not important for your application, version can be set to -1.
Show attributes
Link to section

idempotency_key

string

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

Max Length
45
Link to section

Response fields

Link to section

custom_attribute

The new or updated custom attribute.

Show attributes
Link to section

errors

Any errors that occurred during the request.

Show attributes