--- title: "Changes to Create async request for an account analytics report" method: POST path: "/ad_accounts/{ad_account_id}/reports" --- # Changes to Create async request for an account analytics report `POST /ad_accounts/{ad_account_id}/reports` > Every recorded change to this operation, newest first. ## Timeline Changed in 21 of 29 revisions. - **2026-06-04** (v5) `b698c180678a`: 3 breaking, 7 warning, 33 info - **2025-12-11** (v5) `537bde5a50b1`: 1 breaking, 1 warning - **2025-12-11** (v5) `79f62f71f05b`: 3 info - **2025-10-16** (v5) `14c297539b64`: 7 info - **2025-08-14** (v5) `7d64d863909a`: 1 info - **2025-08-12** (v5) `8fb7ab040159`: 1 breaking, 1 warning - **2025-07-16** (v5) `43134ca41f18`: 1 breaking, 1 warning - **2025-04-04** (v5) `10f9eba4ad97`: 1 breaking, 1 warning - **2024-08-14** (v5) `89c27ed39cfd`: 1 breaking, 1 warning - **2024-04-23** (v5) `f9321315766f`: 1 breaking, 1 warning - **2024-02-08** (v5) `7529b464d5cb`: 1 breaking, 1 warning - **2023-08-17** (v5) `0ff12596bafd`: 1 info - **2023-07-14** (v5) `52586a274771`: 1 breaking, 1 warning - **2023-05-12** (v5) `689b4b267639`: 25 info - **2023-02-14** (v5) `be19b77aa78a`: 1 breaking, 1 info - **2022-11-14** (v5) `e041d7b0cef0`: 1 breaking - **2022-09-07** (v5) `bd20b6eb152f`: 2 breaking, 1 warning - **2022-07-11** (v5) `0d5998752011`: 1 breaking, 1 warning - **2022-04-12** (v5) `723c51158044`: 2 breaking, 3 info - **2022-04-08** (v5) `33ec8e7421c7`: 2 breaking, 1 warning, 2 info - **2022-04-08** (v5) `c561dee8c137`: 1 info ## Changes - **2026-06-04** (v5) `b698c180678a`: 3 breaking, 7 warning, 33 info - added the new required request property `end_date` - added the new required request property `granularity` - added the new required request property `start_date` - removed `subschema #1, subschema #2, subschema #3` from the request body `allOf` list - added the new `CANCELLED` enum value to the `report_status` response property for the response status `200` - added the new `DOES_NOT_EXIST` enum value to the `report_status` response property for the response status `200` - added the new `EXPIRED` enum value to the `report_status` response property for the response status `200` - added the new `FAILED` enum value to the `report_status` response property for the response status `200` - added the new `FINISHED` enum value to the `report_status` response property for the response status `200` - added the new `IN_PROGRESS` enum value to the `report_status` response property for the response status `200` - added the new optional request property `ad_group_ids` - added the new optional request property `ad_group_statuses` - added the new optional request property `ad_ids` - added the new optional request property `ad_statuses` - added the new optional request property `attribution_types` - added the new optional request property `campaign_brand_label` - added the new optional request property `campaign_custom_label` - added the new optional request property `campaign_ids` - added the new optional request property `campaign_objective_types` - added the new optional request property `campaign_statuses` - added the new optional request property `click_window_days` - added the new optional request property `columns` - added the new optional request property `combine_targeting_types` - added the new optional request property `conversion_report_time` - added the new optional request property `custom_conversion_event_metrics` - added the new optional request property `end_hour` - added the new optional request property `engagement_window_days` - added the new optional request property `level` - added the new optional request property `metrics_filters` - added the new optional request property `primary_sort` - added the new optional request property `product_group_ids` - added the new optional request property `product_group_statuses` - added the new optional request property `product_item_ids` - added the new optional request property `report_format` - added the new optional request property `reporting_timezone` - added the new optional request property `start_hour` - added the new optional request property `targeting_types` - added the new optional request property `view_window_days` - added the non-success response with the status `401` - added the non-success response with the status `403` - …3 more - **2025-12-11** (v5) `537bde5a50b1`: 1 breaking, 1 warning - added `subschema #1, subschema #3` to the request body `allOf` list - removed `subschema #1, subschema #3` from the request body `allOf` list - **2025-12-11** (v5) `79f62f71f05b`: 3 info - added the new `PRODUCT_ITEM_CURRENCY` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `TOTAL_APP_INSTALL_CONVERSION_RATE` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `TOTAL_INAPP_APP_INSTALL_CONVERSION_RATE` enum value to the request property `allOf[subschema #3]/columns/items/` - **2025-10-16** (v5) `14c297539b64`: 7 info - added the new optional request property `allOf[subschema #3]/custom_conversion_event_metrics` - added the new `CAMPAIGN_CUSTOM_LABELS` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `TOTAL_ADD_TO_WISHLIST` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `TOTAL_SUBSCRIBE` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `TOTAL_VIDEO_15SEC_UNIQUE_VIEWS` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `VIDEO_15SEC_UNIQUE_VIEWS_1` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `VIDEO_15SEC_UNIQUE_VIEWS_2` enum value to the request property `allOf[subschema #3]/columns/items/` - **2025-08-14** (v5) `7d64d863909a`: 1 info - added the new `LOCAL_ADS_STORE_CODE` enum value to the request property `allOf[subschema #2]/allOf[#/components/schemas/TargetingTypeFilter]/targeting_types/items/` - **2025-08-12** (v5) `8fb7ab040159`: 1 breaking, 1 warning - added `subschema #1, subschema #2` to the request body `allOf` list - removed `subschema #1, subschema #2` from the request body `allOf` list - **2025-07-16** (v5) `43134ca41f18`: 1 breaking, 1 warning - added `subschema #2, subschema #3` to the request body `allOf` list - removed `subschema #2, subschema #3` from the request body `allOf` list - **2025-04-04** (v5) `10f9eba4ad97`: 1 breaking, 1 warning - added `subschema #2, subschema #3` to the request body `allOf` list - removed `subschema #2, subschema #3` from the request body `allOf` list - **2024-08-14** (v5) `89c27ed39cfd`: 1 breaking, 1 warning - added `subschema #2, subschema #3` to the request body `allOf` list - removed `subschema #2, subschema #3` from the request body `allOf` list - **2024-04-23** (v5) `f9321315766f`: 1 breaking, 1 warning - added `subschema #2, subschema #3` to the request body `allOf` list - removed `subschema #2, subschema #3` from the request body `allOf` list - **2024-02-08** (v5) `7529b464d5cb`: 1 breaking, 1 warning - added `subschema #2, subschema #3` to the request body `allOf` list - removed `subschema #2, subschema #3` from the request body `allOf` list - **2023-08-17** (v5) `0ff12596bafd`: 1 info - added the new `STANDARD_AD_FEED_ITEM_ID` enum value to the request property `allOf[subschema #3]/columns/items/` - **2023-07-14** (v5) `52586a274771`: 1 breaking, 1 warning - added `subschema #1, subschema #2, subschema #3` to the request body `allOf` list - removed `subschema #1, subschema #2, subschema #3` from the request body `allOf` list - **2023-05-12** (v5) `689b4b267639`: 25 info - added the new `COST_PER_LEAD` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `COST_PER_OUTBOUND_CLICK` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `LEADS` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `OUTBOUND_CTR` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `PINTEREST_CHECKOUT_COST_PER_ACTION` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `PINTEREST_CHECKOUT_ROAS` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `QUIZ_COMPLETED` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `QUIZ_COMPLETION_RATE` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `SHOWCASE_CARD_THUMBNAIL_SWIPE_BACKWARD` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `SHOWCASE_CARD_THUMBNAIL_SWIPE_FORWARD` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `SHOWCASE_PIN_CLICKTHROUGH` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `SHOWCASE_SUBPAGE_CLICKTHROUGH` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `SHOWCASE_SUBPAGE_CLOSEUP` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `SHOWCASE_SUBPAGE_IMPRESSION` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `SHOWCASE_SUBPAGE_REPIN` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `SHOWCASE_SUBPAGE_SWIPE_LEFT` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `SHOWCASE_SUBPAGE_SWIPE_RIGHT` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `SHOWCASE_SUBPIN_CLICKTHROUGH` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `SHOWCASE_SUBPIN_IMPRESSION` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `SHOWCASE_SUBPIN_REPIN` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `SHOWCASE_SUBPIN_SWIPE_LEFT` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `SHOWCASE_SUBPIN_SWIPE_RIGHT` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `TOTAL_IMPRESSION` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `TOTAL_PINTEREST_CHECKOUT` enum value to the request property `allOf[subschema #3]/columns/items/` - added the new `TOTAL_PINTEREST_CHECKOUT_VALUE_IN_MICRO_DOLLAR` enum value to the request property `allOf[subschema #3]/columns/items/` - **2023-02-14** (v5) `be19b77aa78a`: 1 breaking, 1 info - removed the enum value `AUDIENCE_EXCLUDE` of the request property `allOf[subschema #2]/allOf[#/components/schemas/TargetingTypeFilter]/targeting_types/items/` - added `#/components/schemas/BulkReportingJobStatus` to the `report_status` response property `allOf` list for the response status `200` - **2022-11-14** (v5) `e041d7b0cef0`: 1 breaking - for the `path` request parameter `ad_account_id`, the maxLength was decreased from `19` to `18` - **2022-09-07** (v5) `bd20b6eb152f`: 2 breaking, 1 warning - removed the enum value `AWARENESS_RESERVED` of the request property `allOf[subschema #2]/allOf[subschema #3]/campaign_objective_types/items/` - removed the enum value `ENGAGEMENT` of the request property `allOf[subschema #2]/allOf[subschema #3]/campaign_objective_types/items/` - for the `path` request parameter `ad_account_id`, the maxLength was set to `19` - **2022-07-11** (v5) `0d5998752011`: 1 breaking, 1 warning - added `subschema #2, subschema #3` to the request body `allOf` list - removed `subschema #2, subschema #3` from the request body `allOf` list - **2022-04-12** (v5) `723c51158044`: 2 breaking, 3 info - added the new path request parameter `ad_account_id` - added required request body - api tag `ad_accounts` added - added the non-success response with the status `400` - added the success response with the status `200` - **2022-04-08** (v5) `33ec8e7421c7`: 2 breaking, 1 warning, 2 info - removed the request body - removed the success response with the status `200` - deleted the `path` request parameter `ad_account_id` - api tag `ad_accounts` removed - removed the non-success response with the status `400` - **2022-04-08** (v5) `c561dee8c137`: 1 info - endpoint added --- [Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/ad_accounts/:ad_account_id/reports/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/reports/post)