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

# Create Tier

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

## Request

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

## Request body

- object
  - `name` string, required: The tier name.
  - `discount_percentage` number, required: Discount resellers on this tier get on reseller orders.
  - `is_public` boolean, required: Public tiers are shown on the storefront reseller page.
  - `sort_order` integer, nullable: Must be at least 0. Must not be greater than 1000.
  - `min_spent_usd` number: Auto-advancement threshold: lifetime reseller spend in USD. Null disables this threshold.
  - `min_sales_count` integer: Auto-advancement threshold: lifetime completed reseller orders. Null disables this threshold.
  - `image_id` integer: Optional image shown alongside the tier on the storefront.

## Response `200`

## Changes

- **2026-11-02** `ff0d59c98d7a`: 1 info
  - the request property `sort_order` became nullable

[Operation history](https://skmtc.dev/sellauth/apis/sellauth-api/changes/v1/shops/:shopId/reseller-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/156a9aef5e98?raw)