Bulk Create Negative Keywords
Create multiple negative keywords in a single request.
URL
POST https://api.ads.apple.com/v1/negative-keywords/bulk-createHeader Parameters
| Name | Type | Description |
|---|---|---|
X-Ap-Context Required | string |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | NegativeKeywordCreateBulkResponse | |
| 400 | Bad Request Content-Type: application/json | ErrorResponse | |
| 401 | Unauthorized Content-Type: application/json | ErrorResponse | |
| 403 | Forbidden Content-Type: application/json | ErrorResponse | |
| 404 | Not Found Content-Type: application/json | ErrorResponse | |
| 429 | Too Many Requests Content-Type: application/json | ErrorResponse | |
| 500 | Internal Server Error Content-Type: application/json | ErrorResponse |
Discussion
This endpoint creates multiple negative keywords in a single API call. The request body contains an items array where each item wraps a BulkNegativeKeywordCreate object with a correlationId. You can mix campaign-level and ad-group-level negatives in the same request. The API processes each item independently.
When allowPartialSuccess: true is set in the request, this endpoint uses partial success semantics: if some items in the request fail validation (for example, a duplicate text and matchType combination), the API still creates the successful items. When omitted or false, any single item failure rejects the entire batch. The response includes a per-item result array with each item’s correlationId, success status, the created object, and any error details for failures.