---
title: LocationGroupCreate
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/locationgroupcreate
---

# LocationGroupCreate

The request body object for creating a new location group.

## Declaration

```data
object LocationGroupCreate
```

## Properties

name: Display name for the location group. brandId: Associated brand identifier. adAccountId: Ad account ID that will own this location group. groupType: Type of location grouping. Values: STATIC, DYNAMIC. See groupType Details in the Discussion section. rules: Array of Rule objects for DYNAMIC groups. Provide when groupType is DYNAMIC. locationIds: Array of location IDs for STATIC groups. Provide when groupType is STATIC. description: Optional description of the location group.

## Discussion

Discussion The LocationGroupCreate object is the payload sent to Create Location Group. groupType Details The groupType you choose determines how membership is defined and maintained:  |   |   |  The STATIC groups give precise control over which locations are targeted. The DYNAMIC groups reduce maintenance when the brand’s footprint changes frequently, for example always including every location in a given city without manually updating the group. Once evaluation completes, groupTotal reflects the number of matched locations. Two fields set at creation are locked in permanently:  |   |   |  Creating a group also requires satisfying the following constraints:  |   |   |   |   |  Dynamic Rule Field Values When field is adminArea, the value must be the full English name of the administrative area, such as "Illinois" rather than "IL" or "California" rather than "CA". note: Important: The API accepts abbreviated codes without returning an error, but the system creates the location group with groupTotal: 0 because no locations match. There is no validation error to indicate the mismatch. Use the full name exactly as it appears in a location’s adminArea field (returned by Query for Locations or Get a Location) to ensure rules evaluate correctly. Status After creation, a DYNAMIC group’s systemStatus is initially PENDING while Apple Ads evaluates the rules. The STATIC groups are VALID immediately, since membership is an explicit list rather than something to evaluate. Wait for systemStatus: VALID before using a DYNAMIC group in ad group targeting. Example {   "name": "West Coast Stores",   "brandId": "9151314442816847872",   "adAccountId": "293897290",   "groupType": "DYNAMIC",   "rules": [     {       "field": "adminArea",       "operator": "IN",       "value": [         "California",         "New York"       ]     }   ],   "description": "All AwayFinder retail stores on the West Coast" }

## See Also

- [Brand](apple-ads-platform-api/brand.md)
- [BrandResponse](apple-ads-platform-api/brandresponse.md)
- [BrandQueryResponse](apple-ads-platform-api/brandqueryresponse.md)
- [BrandRejectionReasonResponse](apple-ads-platform-api/brandrejectionreasonresponse.md)
- [BusinessCategory](apple-ads-platform-api/businesscategory.md)
- [BusinessCategoryResponse](apple-ads-platform-api/businesscategoryresponse.md)
- [BusinessCategoryQueryResponse](apple-ads-platform-api/businesscategoryqueryresponse.md)
- [Location](apple-ads-platform-api/location.md)
- [LocationResponse](apple-ads-platform-api/locationresponse.md)
- [LocationGroup](apple-ads-platform-api/locationgroup.md)
- [LocationGroupUpdate](apple-ads-platform-api/locationgroupupdate.md)
- [LocationGroupResponse](apple-ads-platform-api/locationgroupresponse.md)
- [LocationGroupQueryResponse](apple-ads-platform-api/locationgroupqueryresponse.md)
- [LocationQueryResponse](apple-ads-platform-api/locationqueryresponse.md)
- [Eligibility](apple-ads-platform-api/eligibility.md)