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

# AdCreate

The request body for creating a new Ad object.

## Declaration

```data
object AdCreate
```

## Properties

adGroupId: The ad group this ad belongs to. Must be a valid ad group ID within the same account. creativeId: The identifier of the ad creative to link to this ad. The ad creative must have a systemStatus of VALID. name: Advertiser-given name for this ad. Must be at least 1 character long. status: Advertiser-configurable status. Set to ENABLED to allow the ad to participate in auctions, or PAUSED to create it in a suspended state. See AdStatus.

## Discussion

Discussion Creating an ad links an ad creative to an ad group with POST /v1/ads (Create an Ad). An ad can’t be enabled until its parent ad group and campaign are also enabled. Example {   "adGroupId": 555666777,   "creativeId": 666777888,   "name": "AwayFinder Default Product Page",   "status": "ENABLED" }

## Topics

### Type Aliases

- [AdCreate.Status](apple-ads-platform-api/adcreate/status-data.typealias.md)

## See Also

- [Ad](apple-ads-platform-api/ad.md)
- [AdUpdate](apple-ads-platform-api/adupdate.md)
- [AdResponse](apple-ads-platform-api/adresponse.md)
- [AdQueryResponse](apple-ads-platform-api/adqueryresponse.md)