---
title: "Changes to Create commerce integration"
method: POST
path: "/integrations/commerce"
---

# Changes to Create commerce integration

`POST /integrations/commerce`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 29 revisions.

- **2026-06-04** (v5) `b698c180678a`: 1 breaking, 14 info
- **2025-12-11** (v5) `79f62f71f05b`: 1 breaking
- **2025-04-04** (v5) `10f9eba4ad97`: 1 breaking
- **2023-08-17** (v5) `0ff12596bafd`: 2 breaking
- **2023-05-12** (v5) `689b4b267639`: 15 info
- **2023-02-14** (v5) `be19b77aa78a`: 1 info

## Changes

- **2026-06-04** (v5) `b698c180678a`: 1 breaking, 14 info
  - the `id` response's property type changed from `string` to no type for status `200`
  - the `partner_access_token_expiry` request property type was generalized from `integer` to `number`
  - the `partner_refresh_token_expiry` request property type was generalized from `integer` to `number`
  - 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 `429`
  - removed the non-success response with the status `409`
  - the response optional property `connected_advertiser_id` became not read-only for the status `200`
  - the response optional property `created_timestamp` became read-only for the status `200`
  - the response optional property `id` became read-only for the status `200`
  - the response optional property `updated_timestamp` became read-only for the status `200`
  - added `#/components/schemas/Pinterest.Lib.IntegerFormatType` to the `id` response property `allOf` list for the response status `200`
  - the `id` response's property pattern `^\d+$` was removed for the status `200`
  - added the success response with the status `201`
- **2025-12-11** (v5) `79f62f71f05b`: 1 breaking
  - request body became required
- **2025-04-04** (v5) `10f9eba4ad97`: 1 breaking
  - the request property `external_business_id` became not nullable
- **2023-08-17** (v5) `0ff12596bafd`: 2 breaking
  - the `partner_access_token_expiry` request property type changed from `number` to `integer`
  - the `partner_refresh_token_expiry` request property type changed from `number` to `integer`
- **2023-05-12** (v5) `689b4b267639`: 15 info
  - added the new optional request property `additional_id_1`
  - added the new optional request property `partner_access_token_expiry`
  - added the new optional request property `partner_metadata`
  - added the new optional request property `partner_refresh_token`
  - added the new optional request property `partner_refresh_token_expiry`
  - added the new optional request property `scopes`
  - the request property `external_business_id` became nullable
  - added the optional property `additional_id_1` to the response with the `200` status
  - added the optional property `created_timestamp` to the response with the `200` status
  - added the optional property `id` to the response with the `200` status
  - added the optional property `partner_access_token_expiry` to the response with the `200` status
  - added the optional property `partner_metadata` to the response with the `200` status
  - added the optional property `partner_refresh_token_expiry` to the response with the `200` status
  - added the optional property `scopes` to the response with the `200` status
  - added the optional property `updated_timestamp` to the response with the `200` status
- **2023-02-14** (v5) `be19b77aa78a`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/integrations/commerce/post.md) - [API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) - [Page](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/integrations/commerce/post)