---
title: Create a Negative Keyword
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/post-negative-keywords
---

# Create a Negative Keyword

Create a negative keyword at the campaign or ad group level to prevent ads from showing for unwanted search terms.

## URL

POST https://api.ads.apple.com/v1/negative-keywords

## Header Parameters

X-Ap-Context:

## Response Codes

200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 Too Many Requests: 500 Internal Server Error:

## Discussion

Discussion This endpoint creates one negative keyword per request. To create many negative keywords in a single call, use Bulk Create Negative Keywords. Negative keywords prevent your ads from showing when a user’s search query contains a term you want to exclude. They block traffic rather than compete for it. Negative keywords can be created at two levels, campaign or ad group, each with distinct field requirements and scope. Use Campaign-Level Negative Keywords Campaign-level negative keywords block ads from appearing for excluded search terms across all ad groups in the campaign. Use campaign-level negatives when you want broad exclusions that apply uniformly throughout an entire campaign. A campaign-level negative keyword requires campaignId and leaves adGroupId unset.  |   |   |  Use Ad-Group-Level Negative Keywords Ad group-level negative keywords are scoped to a single ad group. Use ad group-level negatives when you need finer control over exclusions for a specific ad group within a campaign. An ad-group-level negative keyword requires adGroupId and leaves campaignId unset.  |   |   |  Payload Examples

## See Also

- [Query Negative Keywords](apple-ads-platform-api/post-negative-keywords-query.md)
- [Get a Negative Keyword](apple-ads-platform-api/get-negative-keywords-_id_.md)
- [Update a Negative Keyword](apple-ads-platform-api/put-negative-keywords-_id_.md)
- [Delete a Negative Keyword](apple-ads-platform-api/delete-negative-keywords-_id_.md)