---
title: "Create a tier"
method: POST
path: "/v2/tiers"
tags: ["Tiers"]
---

# Create a tier

`POST /v2/tiers`

Creates a new tier for the given tier collection

## Request body

- object
  - `benefits` object[], required — Benefits of this tier
    - `description` string — Description of the tier's benefit
    - `name` string — Name of the tier's benefit
    - `order` integer, nullable — Display order of the benefit (0-based)
  - `criteria` string[], required — Partner criteria for this tier
  - `name` string, required — Specifies name of the Tier
  - `tier_collection_key` string, required — A unique identifier for the parent collection

## Response `200`

Creates a new tier for the given tier collection

- object
  - `data` object, required — Standard fields that are present on all database objects.
    - `created_at` integer — Immutable Unix timestamp in milliseconds taken at time of creation
    - `key` string — A unique identifier used to reference the object
    - `updated_at` integer — Unix timestamp in milliseconds taken at time of last update
    - `benefits` object[] — Benefits of this tier
      - `description` string — Description of the tier's benefit
      - `name` string — Name of the tier's benefit
      - `order` integer, nullable — Display order of the benefit (0-based)
    - `color` string, nullable — Custom tier color for logo
    - `criteria` string[]
    - `features` object, nullable
    - `img` string, nullable — A unique identifier for the uploaded image/badge
    - `is_active` boolean, nullable
    - `is_current` boolean, nullable
    - `min_threshold` integer, nullable
    - `name` string, nullable — Specifies name of the Tier
    - `next_tier_key` string, nullable
    - `order` integer, nullable
    - `prev_tier_key` string, nullable
    - `threshold_type` 'net_sales' | 'custom_criteria', nullable — Type of tier threshold
    - `tier_collection_key` string, nullable — A unique identifier for the parent collection
  - `message` string, required
  - `status` integer, required

## Other responses

- `400` — Bad Request Error
- `401` — Unauthorized Error
- `403` — Forbidden Error
- `404` — Not Found Error
- `500` — Internal Server Error

---

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