<- Locations API

Locations API

Create location

POST

 /v2/locations

Creates a location.

Creating new locations allows for separate configuration of receipt layouts, item prices, and sales reports. Developers can use locations to separate sales activity through applications that integrate with Square from sales activity elsewhere in a seller's account. Locations created programmatically with the Locations API last forever and are visible to the seller for their own management. Therefore, ensure that each location has a sensible and unique name.

Permissions:MERCHANT_PROFILE_WRITE

Guide

Create a location

Try in API Explorer
Link to section

Request body

Example code

Link to section

location

The initial values of the location being created. The name field is required and must be unique within a seller account. All other fields are optional, but any information you care about for the location should be included. The remaining fields are automatically added based on the data from the main location.

Show attributes
Link to section

Response fields

Link to section

errors

Information about errors encountered during the request.

Show attributes
Link to section

location

The newly created Location object.

Show attributes