Create a Keyword
Create a new keyword in an ad group, setting the match type and optional bid amount.
URL
POST https://api.ads.apple.com/v1/keywordsHeader Parameters
| Name | Type | Description |
|---|---|---|
X-Ap-Context Required | string |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | KeywordResponse | |
| 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 one keyword per request. To create many keywords in a single call, use Bulk Create Keywords.
Creates a keyword in an ad group. Each keyword belongs to an ad group via adGroupId, which is required at creation and immutable afterward. The text field is the search term itself and is also immutable after creation. To change a keyword’s text, delete it and create a new one.
Omitting bid or passing null on create defaults the keyword to the ad group’s bid strategy. This differs from Update a Keyword, where null isn’t accepted for bid. See Managing Keywords and Negative Keywords for the full explanation.