<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/Create-Location-Group",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "rest:apple-ads-platform-api:post:location-groups"
  },
  "title" : "Create Location Group"
}
-->

# Create Location Group

Create a named group of locations for geographic targeting.

## Discussion

Location groups define which physical locations are in scope for an ad group. All other settings, including schedule, creatives, and bids, live on the ad group or ad itself. Each group belongs to a single brand and ad account. You set both at creation, and neither can change afterward. Once created, reference the group’s `id` in an ad group’s targeting configuration to restrict delivery to those locations.

## Request Body

See [`LocationGroupCreate`](/documentation/Apple-Ads-Platform-API/LocationGroupCreate).

## Payload Examples

**Static Group:**

### Request

Creates a static group with an explicit list of location IDs.

```json
{
 "name": "AwayFinder Downtown Stores",
 "brandId": "9151314442816847872",
 "adAccountId": "293897290",
 "groupType": "STATIC",
 "locationIds": [
   "7205759403792794",
   "7205759403792795"
 ]
}
```

### Response

```json
{
 "result": {
   "id": "5764607523034238976",
   "name": "AwayFinder Downtown Stores",
   "brandId": "9151314442816847872",
   "adAccountId": "293897290",
   "groupType": "STATIC",
   "systemStatus": "VALID",
   "locationIds": [
     "7205759403792794",
     "7205759403792795"
   ],
   "groupTotal": 2,
   "isAllLocationsGroup": false,
   "creationTime": "2026-02-01T09:00:00Z",
   "modificationTime": "2026-02-01T09:00:00Z",
   "eligibility": {
     "status": "ELIGIBLE"
   }
 }
}
```

**Dynamic Group:**

### Request

Creates a dynamic group that automatically includes all locations in the specified states.

```json
{
 "name": "AwayFinder West Coast Stores",
 "brandId": "9151314442816847872",
 "adAccountId": "293897290",
 "groupType": "DYNAMIC",
 "rules": [
   {
     "field": "adminArea",
     "operator": "IN",
     "value": [
       "California",
       "Oregon",
       "Washington"
     ]
   }
 ],
 "description": "All AwayFinder locations on the West Coast"
}
```

### Response

```json
{
 "result": {
   "id": "5764607523034238977",
   "name": "AwayFinder West Coast Stores",
   "brandId": "9151314442816847872",
   "adAccountId": "293897290",
   "groupType": "DYNAMIC",
   "systemStatus": "PENDING",
   "rules": [
     {
       "field": "adminArea",
       "operator": "IN",
       "value": [
         "California",
         "Oregon",
         "Washington"
       ]
     }
   ],
   "groupTotal": 0,
   "isAllLocationsGroup": false,
   "description": "All AwayFinder locations on the West Coast",
   "creationTime": "2026-02-01T09:00:00Z",
   "modificationTime": "2026-02-01T09:00:00Z",
   "eligibility": {
     "status": "PENDING"
   }
 }
}
```

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)