---
title: "Create Tier"
method: POST
path: "/v1/shops/{shopId}/affiliate-tiers"
tags: ["Affiliate Tiers"]
---

# Create Tier

`POST /v1/shops/{shopId}/affiliate-tiers`

## Request

- Base URL: `https://api.sellauth.com`
- URL: `https://api.sellauth.com/v1/shops/{shopId}/affiliate-tiers`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sellauth/apis/sellauth-api/docs/v1/shops/:shopId/affiliate-tiers/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- object
  - `name` string, required: The tier name.
  - `percentage` number, required: Commission percentage for the tier.
  - `discount_percentage` number, required: Discount buyers get when using a code of this tier.
  - `is_public` boolean, required: Public tiers are shown on the storefront affiliate page.
  - `sort_order` integer, nullable: Must be at least 0. Must not be greater than 1000.
  - `attribution_mode` string: Overrides the shop attribution mode for this tier's affiliates: per_order, lifetime_last or lifetime_first. Null inherits the shop setting.
  - `attribution_window_days` integer: Overrides the shop attribution window (1-999 days) for links using this tier's codes. Null inherits the shop setting.

## Response `200`

## Changes

- **2026-11-02** `ff0d59c98d7a`: 1 info
  - the request property `sort_order` became nullable
- **2026-09-14** `12c8f48a9963`: 2 info
  - added the new optional request property `attribution_mode`
  - added the new optional request property `attribution_window_days`

[Operation history](https://skmtc.dev/sellauth/apis/sellauth-api/changes/v1/shops/:shopId/affiliate-tiers/post.md)

---

[API](https://skmtc.dev/sellauth/apis/sellauth-api.md) - [All operations](https://skmtc.dev/sellauth/apis/sellauth-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sellauth/apis/sellauth-api/revisions/ff0d59c98d7a?raw)