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

# NegativeKeywordCreate

The request body for creating a new negative keyword.

## Declaration

```data
object NegativeKeywordCreate
```

## Properties

campaignId: Scopes this negative keyword to a specific campaign. Required for campaign-level negatives when calling POST /v1/negative-keywords (Create a Negative Keyword) directly. Must not be set for ad group-level negatives. adGroupId: Scopes this negative keyword to a specific ad group. Required for ad group-level negatives when calling POST /v1/negative-keywords (Create a Negative Keyword) directly. Don’t set campaignId when providing this field. text: The keyword text to exclude. Immutable after creation. To correct it, delete the existing record and create a new one. matchType: The match type for this negative keyword. See KeywordMatchType. Defaults to BROAD if omitted. Immutable after creation. status: Whether this negative keyword is active. See NegativeKeywordStatus. Defaults to ENABLED if omitted.

## Discussion

Discussion The NegativeKeywordCreate object is the request payload for adding a negative keyword to a campaign or ad group. Example {   "campaignId": 123456789,   "text": "AwayFinder competitor app",   "matchType": "PHRASE",   "status": "ENABLED" }

## Topics

### Type Aliases

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

## See Also

- [NegativeKeyword](apple-ads-platform-api/negativekeyword.md)
- [NegativeKeywordUpdate](apple-ads-platform-api/negativekeywordupdate.md)
- [NegativeKeywordResponse](apple-ads-platform-api/negativekeywordresponse.md)
- [NegativeKeywordQueryResponse](apple-ads-platform-api/negativekeywordqueryresponse.md)