Skip to main content
POST
Create an attribution Amazon link

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

Inputs for creating an attribution Amazon link.

A name for the link — used so you can tell it apart from your other links in reports.

Example:

"spring-2026-yt-campaign"

asin
string | null

The Amazon product identifier you want to link to. Required for product links and mutually exclusive with store_page_id.

Example:

"B0D45KS7QM"

store_page_id
string | null

Brand-scoped storefront page identifier returned by GET /storefront_links. Requires brand_id and is mutually exclusive with asin.

Example:

"PAGE-1"

brand_id
string | null

Brand identifier from the same GET /storefront_links row. Required with store_page_id because page identifiers are not globally unique.

Example:

"65f0f0f0f0f0f0f0f0f0f001"

marketplace
string | null
default:amazon.com

Product links only: the destination marketplace, defaulting to amazon.com. Do not send this field with store_page_id; storefront requests derive the marketplace from the page and reject an explicitly supplied marketplace.

Example:

"amazon.com"

Response

Successful Response

The newly created attribution link.

url
string
required

The canonical attribution Amazon URL — share this anywhere shoppers will click it.

Same value as url. Kept for older integrations that already read this field.

marketplace
string
required

The Amazon marketplace the link sends shoppers to.

id
string | null

The link's identifier on the Archer platform. Use it to look up performance in /reports.

asin
string | null

The product the link points at; null for storefront links.

type
string
default:product

What the link points to: product or storefront.

active
boolean
default:true

False if you later pause reporting for this link.

store_page_id
string | null

The storefront page identifier used to create this link; null for product links.

page_name
string | null
page_url
string | null