---
title: Create a 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-keywords
---

# 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/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 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. Payload Examples

## See Also

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