---
agentTools:
  projectIndex: https://developers.brandwatch.com/llms.txt
---

# Creating Location Lists

Creating a list of Locations in Brandwatch Consumer Research.

The below call will create a Location List called "Northeastern Cities" in the [Project with ID](https://developers.brandwatch.com/docs/retrieving-projects) `1998159493`.  This Location List will be shared with this project only (`sharedProjectIds`), but can be edited by anyone (`shared`):

[block:code]
{
  "codes": [
    {
      "code": "curl -X POST \\\n  'https://api.brandwatch.com/projects/1998159493/group/location/' \\\n  -H 'content-type: application/json' \\\n  -d '{\"name\":\"Northeastern Cities\",\"locations\":[{\"id\":\"new8\"},{\"id\":\"bos1\"},{\"id\":\"phig\"},{\"id\":\"bali\"},{\"id\":\"wdc0\"}],\"sharedProjectIds\":[1998159493],\"shared\":\"public\"}'",
      "language": "curl"
    }
  ]
}
[/block]

For a list of Brandwatch location ids, please contact <support@brandwatch.com>.

The response will be similar to the following:

[block:code]
{
  "codes": [
    {
      "code": "{\n    \"id\": 192667493,\n    \"name\": \"Northeastern Cities\",\n    \"shared\": \"public\",\n    \"sharedProjectIds\": [\n        1998159493\n    ],\n    \"locations\": [\n        {\n            \"id\": \"wdc0\",\n            \"name\": \"Washington\",\n            \"type\": \"city\",\n            \"fullName\": \"Washington, District of Columbia, District of Columbia, United States, North America\"\n        },\n        {\n            \"id\": \"phig\",\n            \"name\": \"Philadelphia\",\n            \"type\": \"city\",\n            \"fullName\": \"Philadelphia, Philadelphia County, Pennsylvania, United States, North America\"\n        },\n        {\n            \"id\": \"bos1\",\n            \"name\": \"Boston\",\n            \"type\": \"city\",\n            \"fullName\": \"Boston, Suffolk County, Massachusetts, United States, North America\"\n        },\n        {\n            \"id\": \"bali\",\n            \"name\": \"Baltimore\",\n            \"type\": \"city\",\n            \"fullName\": \"Baltimore, Baltimore County, Maryland, United States, North America\"\n        },\n        {\n            \"id\": \"new8\",\n            \"name\": \"New York City\",\n            \"type\": \"city\",\n            \"fullName\": \"New York City, New York County, New York, United States, North America\"\n        }\n    ],\n    \"userName\": \"example@brandwatch.com\",\n    \"userId\": 117025679\n}",
      "language": "json"
    }
  ]
}
[/block]