Create location BETA
POST
/v2/locations
Creates a location.
For more information about locations, see Locations API Overview.
Permissions
MERCHANT_PROFILE_WRITE
Try in API Explorer
| Name | Description |
|---|---|
location
|
The initial values of the location being created. The |
Response Fields
| Name | Description |
|---|---|
errors
|
Information on errors encountered during the request. |
location
|
The newly created |
Examples
POST
/v2/locations
cURL
- cURL
- Ruby
- Python
- C#
- Java
- PHP
curl https://connect.squareup.com/v2/locations \
-X POST \
-H 'Square-Version: 2020-09-23' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"location": {
"name": "New location name",
"description": "My new location.",
"facebook_url": null,
"address": {
"address_line_1": "1234 Peachtree St. NE",
"administrative_district_level_1": "GA",
"locality": "Atlanta",
"postal_code": "30309"
}
}
}'
Response JSON
{
"location": {
"id": "LOCATION_ID",
"name": "New location name",
"address": {
"address_line_1": "1234 Peachtree St. NE",
"locality": "Atlanta",
"administrative_district_level_1": "GA",
"postal_code": "30309"
},
"capabilities": [
"CREDIT_CARD_PROCESSING"
],
"status": "ACTIVE",
"created_at": "2019-07-19T17:58:25Z",
"merchant_id": "MERCHANT_ID",
"country": "US",
"language_code": "en-US",
"currency": "USD",
"type": "PHYSICAL",
"description": "My new location.",
"website_url": "examplewebsite.com",
"twitter_username": "twitter",
"instagram_username": "instagram",
"coordinates": {
"latitude": 33.788567,
"longitude": -84.466947
},
"mcc": "1234"
}
}