---
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
  - `connected_merchant_id` string
  - `connected_advertiser_id` string
  - `connected_lba_id` string
  - `connected_tag_id` string
  - `partner_access_token` string
  - `partner_primary_email` string

## Response `200`

Success

- IntegrationMetadata — Integration metadata
  - `external_business_id` string
  - `connected_merchant_id` string
  - `connected_user_id` string
  - `connected_advertiser_id` string
  - `connected_lba_id` string
  - `connected_tag_id` string

## Other responses

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

## Changes

- **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/be19b77aa78a/schema)