---
title: "Update commerce integration"
method: PATCH
path: "/integrations/commerce/{external_business_id}"
tags: ["integrations"]
---

# Update commerce integration

`PATCH /integrations/commerce/{external_business_id}`

Update commerce integration metadata for the given external business ID

## Path parameters

- `external_business_id` string, required

## Request body

- IntegrationRequestPatch — Schema used for updating the integration metadata.
  - `connected_merchant_id` string
  - `connected_advertiser_id` string
  - `connected_lba_id` string
  - `connected_tag_id` string
  - `partner_access_token` string
  - `partner_refresh_token` string
  - `partner_primary_email` string
  - `partner_access_token_expiry` number
  - `partner_refresh_token_expiry` number
  - `scopes` string
  - `additional_id_1` string
  - `partner_metadata` string

## Response `200`

Success

- IntegrationMetadata — Integration metadata
  - `id` string
  - `external_business_id` string
  - `connected_merchant_id` string
  - `connected_user_id` string
  - `connected_advertiser_id` string
  - `connected_lba_id` string
  - `connected_tag_id` string
  - `partner_access_token_expiry` number
  - `partner_refresh_token_expiry` number
  - `scopes` string
  - `created_timestamp` number
  - `updated_timestamp` number
  - `additional_id_1` string
  - `partner_metadata` string

## Other responses

- `404` — Integration not found.
- `409` — Can't access this integration metadata.
- `default` — Unexpected error.

## Changes

- **2023-05-12** (v5) `689b4b267639` — 14 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`
  - …10 more
- **2023-02-14** (v5) `be19b77aa78a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/integrations/commerce/:external_business_id/patch.md)

---

[API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) · [All operations](https://skmtc.dev/pinterest/apis/pinterest-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pinterest/pinterest-rest-api/revisions/0ff12596bafd/schema)