--- title: "Changes to Create keywords" method: POST path: "/ad_accounts/{ad_account_id}/keywords" --- # Changes to Create keywords `POST /ad_accounts/{ad_account_id}/keywords` > Every recorded change to this operation, newest first. ## Timeline Changed in 5 of 29 revisions. - **2026-06-04** (v5) `b698c180678a`: 8 breaking, 28 info - **2024-04-23** (v5) `f9321315766f`: 10 warning, 10 info - **2023-02-14** (v5) `be19b77aa78a`: 1 breaking - **2022-11-14** (v5) `e041d7b0cef0`: 4 breaking, 1 info - **2022-09-07** (v5) `bd20b6eb152f`: 1 info ## Changes - **2026-06-04** (v5) `b698c180678a`: 8 breaking, 28 info - added `#/components/schemas/MatchType` to the `keywords/items/match_type` request property `allOf` list - removed the enum value `BROAD` of the request property `keywords/items/match_type` - removed the enum value `EXACT` of the request property `keywords/items/match_type` - removed the enum value `EXACT_NEGATIVE` of the request property `keywords/items/match_type` - removed the enum value `PHRASE` of the request property `keywords/items/match_type` - removed the enum value `PHRASE_NEGATIVE` of the request property `keywords/items/match_type` - removed the enum value `undefined` of the request property `keywords/items/match_type` - the `keywords/items/match_type` request property type changed from `string` to no type - removed the pattern `^((AG)|C)?\d+$` from the request property `parent_id` - added the non-success response with the status `400` - added the non-success response with the status `401` - added the non-success response with the status `403` - added the non-success response with the status `404` - added the non-success response with the status `429` - added the optional property `errors/items/data/archived` to the response with the `200` status - added the optional property `errors/items/data/bid` to the response with the `200` status - added the optional property `errors/items/data/parent_type` to the response with the `200` status - added the optional property `errors/items/data/type` to the response with the `200` status - added the optional property `keywords/items/archived` to the response with the `200` status - added the optional property `keywords/items/bid` to the response with the `200` status - added the optional property `keywords/items/parent_type` to the response with the `200` status - added the optional property `keywords/items/type` to the response with the `200` status - the response optional property `errors` became read-only for the status `200` - removed `#/components/schemas/KeywordsCommon, subschema #2` from the `errors/items/data` response property `allOf` list for the response status `200` - removed `#/components/schemas/KeywordsCommon, subschema #2` from the `keywords/items/` response property `allOf` list for the response status `200` - the response property `errors` became required for the status `200` - the response property `keywords` became required for the status `200` - added the required property `errors/items/data/id` to the response with the `200` status - added the required property `errors/items/data/match_type` to the response with the `200` status - added the required property `errors/items/data/parent_id` to the response with the `200` status - added the required property `errors/items/data/value` to the response with the `200` status - added the required property `keywords/items/id` to the response with the `200` status - added the required property `keywords/items/match_type` to the response with the `200` status - added the required property `keywords/items/parent_id` to the response with the `200` status - added the required property `keywords/items/value` to the response with the `200` status - added the success response with the status `201` - **2024-04-23** (v5) `f9321315766f`: 10 warning, 10 info - removed the optional property `errors/items/data/archived` from the response with the `200` status - removed the optional property `errors/items/data/id` from the response with the `200` status - removed the optional property `errors/items/data/parent_id` from the response with the `200` status - removed the optional property `errors/items/data/parent_type` from the response with the `200` status - removed the optional property `errors/items/data/type` from the response with the `200` status - removed the optional property `keywords/items/archived` from the response with the `200` status - removed the optional property `keywords/items/id` from the response with the `200` status - removed the optional property `keywords/items/parent_id` from the response with the `200` status - removed the optional property `keywords/items/parent_type` from the response with the `200` status - removed the optional property `keywords/items/type` from the response with the `200` status - added the optional property `errors/items/data/allOf[subschema #2]/archived` to the response with the `200` status - added the optional property `errors/items/data/allOf[subschema #2]/id` to the response with the `200` status - added the optional property `errors/items/data/allOf[subschema #2]/parent_id` to the response with the `200` status - added the optional property `errors/items/data/allOf[subschema #2]/parent_type` to the response with the `200` status - added the optional property `errors/items/data/allOf[subschema #2]/type` to the response with the `200` status - added the optional property `keywords/items/allOf[subschema #2]/archived` to the response with the `200` status - added the optional property `keywords/items/allOf[subschema #2]/id` to the response with the `200` status - added the optional property `keywords/items/allOf[subschema #2]/parent_id` to the response with the `200` status - added the optional property `keywords/items/allOf[subschema #2]/parent_type` to the response with the `200` status - added the optional property `keywords/items/allOf[subschema #2]/type` to the response with the `200` status - **2023-02-14** (v5) `be19b77aa78a`: 1 breaking - the response's body type changed from no type to `object` for status `200` - **2022-11-14** (v5) `e041d7b0cef0`: 4 breaking, 1 info - for the `path` request parameter `ad_account_id`, the maxLength was decreased from `19` to `18` - the `keywords/items/bid` request property type changed from `number` to `integer` - the response property `errors/items/data/allOf[#/components/schemas/KeywordsCommon]/bid` became nullable for the status `200` - the response property `keywords/items/allOf[#/components/schemas/KeywordsCommon]/bid` became nullable for the status `200` - the request property `keywords/items/bid` became nullable - **2022-09-07** (v5) `bd20b6eb152f`: 1 info - endpoint added --- [Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/ad_accounts/:ad_account_id/keywords/post.md) - [API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) - [Page](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/ad_accounts/:ad_account_id/keywords/post)