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

# KeywordCreate

The request body for creating a new Keyword object.

## Declaration

```data
object KeywordCreate
```

## Properties

adGroupId: The ad group this keyword targets. text: The keyword text as entered by the advertiser. Can’t be changed after creation. To change it, delete the keyword and create a new one. matchType: The match type for this keyword. Values: EXACT, BROAD, PHRASE, CATEGORY. See KeywordMatchType. Immutable after creation. To change it, delete the keyword and create a new one. bid: Per-keyword bid override as a Money object. See Money. Overrides the ad group default bid. Omit or pass null to default to the ad group’s BidStrategy bid. Not used with Maximize Conversions bid strategy campaigns. status: Whether this keyword is active and eligible to serve. Values: ENABLED, PAUSED. See KeywordStatus.

## Discussion

Discussion The KeywordCreate object is the request payload for adding a keyword to an ad group via POST /v1/keywords (Create a Keyword), after the ad group has already been created. The AdGroupCreate doesn’t support keywords inline. See the properties below for field-level requirements, mutability, and defaults. Example {   "adGroupId": 555666777,   "text": "photo editor",   "matchType": "EXACT",   "bid": {     "amount": "2.50",     "currency": "USD"   },   "status": "ENABLED" }

## Topics

### Type Aliases

- [KeywordCreate.MatchType](apple-ads-platform-api/keywordcreate/matchtype-data.typealias.md)
- [KeywordCreate.Status](apple-ads-platform-api/keywordcreate/status-data.typealias.md)

## See Also

- [Keyword](apple-ads-platform-api/keyword.md)
- [KeywordUpdate](apple-ads-platform-api/keywordupdate.md)
- [KeywordResponse](apple-ads-platform-api/keywordresponse.md)
- [KeywordQueryResponse](apple-ads-platform-api/keywordqueryresponse.md)