---
title: "Create commerce integration"
method: POST
path: "/integrations/commerce"
tags: ["integrations"]
---

# Create commerce integration

`POST /integrations/commerce`

Create commerce integration metadata to link an external business ID with a Pinterest merchant & ad account.

## Request body

- IntegrationRequest — Schema used for creating the integration metadata.
  - `external_business_id` string, nullable — External business ID for the integration.
  - `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` integer
  - `partner_refresh_token_expiry` integer
  - `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-08-17** (v5) `0ff12596bafd` — 2 breaking
  - the `partner_access_token_expiry` request property type/format changed from `number`/`` to `integer`/``
  - the `partner_refresh_token_expiry` request property type/format 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`
  - …11 more
- **2023-02-14** (v5) `be19b77aa78a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/integrations/commerce/post.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)