Create an attribution Amazon link
Create an Amazon attribution link for either a product or a storefront page.
Product links
Pass asin, link_name, and optionally marketplace. The marketplace defaults
to amazon.com.
Storefront links
First call GET /storefront_links with a brand_id or exact brand_name.
Choose a returned row and pass both its brand_id and store_page_id here,
together with link_name. Store page IDs are scoped to a brand, so brand_id
is required for storefront generation. The storefront page determines the
marketplace. Requests that explicitly include both store_page_id and
marketplace are rejected.
Provide exactly one of asin or store_page_id. In the response, url is the
canonical shareable attribution URL; attribution_link mirrors it for legacy
clients. The response id identifies the generated link for reporting.
Naming your link
link_name is for your own bookkeeping and appears in /reports and
/get_all_links.
When things go wrong
- Destination not found - the ASIN or storefront id is unavailable.
- Brand disabled the storefront - choose a product link or another brand.
- Could not reach Amazon - retry after a short delay.
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Body
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.
"spring-2026-yt-campaign"
The Amazon product identifier you want to link to. Required for product links and mutually exclusive with store_page_id.
"B0D45KS7QM"
Brand-scoped storefront page identifier returned by GET /storefront_links. Requires brand_id and is mutually exclusive with asin.
"PAGE-1"
Brand identifier from the same GET /storefront_links row. Required with store_page_id because page identifiers are not globally unique.
"65f0f0f0f0f0f0f0f0f0f001"
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.
"amazon.com"
Response
Successful Response
The newly created attribution link.
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.
The Amazon marketplace the link sends shoppers to.
The link's identifier on the Archer platform. Use it to look up performance in /reports.
The product the link points at; null for storefront links.
What the link points to: product or storefront.
False if you later pause reporting for this link.
The storefront page identifier used to create this link; null for product links.