---
title: "Create Product Link"
method: POST
path: "/links"
tags: ["Links"]
---

# Create Product Link

`POST /links`

## Request body

- object
  - `product` object, required
    - `primary_id` string, required
    - `marketplace` 'amazon.com' | 'amazon.com.mx' | 'amazon.co.uk' | 'amazon.ca' | 'amazon.de' | 'amazon.es' | 'amazon.fr' | 'amazon.it' | 'amazon.nl' | 'walmart.com' | 'shopify.com', required — Represents a Levanta marketplace (ex: amazon.co.uk, walmart.com, shopify.com).
  - `subid1` string — An ID that identifies where the created link will be used. Allowed characters: [a-zA-Z0-9-_@./ ]
  - `subid2` string — An ID that identifies where the created link will be used. Allowed characters: [a-zA-Z0-9-_@./ ]
  - `sharedid` string — Will be added to the link parameters as `sharedid`. NOTE: only supported when product.marketplace is shopify.com, otherwise an 422 error will be thrown.

## Response `200`

Success

- object
  - `id` string, required
  - `type` 'product' | 'storefront', required
  - `marketplace` 'amazon.com' | 'amazon.com.mx' | 'amazon.co.uk' | 'amazon.ca' | 'amazon.de' | 'amazon.es' | 'amazon.fr' | 'amazon.it' | 'amazon.nl' | 'walmart.com' | 'shopify.com', required — The marketplace the link is associated with
  - `url` string, required
  - `mobileOptimizedUrl` string, required

## Other responses

- `400` — You do not have permission to create a link for this product
- `401` — Unauthorized
- `404` — Product Not Found
- `415` — Invalid Content Type: Must be "application/json" for post requests
- `422` — Input Validation Failed

---

[API](https://skmtc.dev/levanta/apis/levanta-creator-api-v2.md) · [All operations](https://skmtc.dev/levanta/apis/levanta-creator-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/levanta/levanta-creator-api-v2/revisions/f5dfab95939b/schema)