---
title: "Create fee model"
method: POST
path: "/v1/fee/models"
tags: ["Fee models"]
---

# Create fee model

`POST /v1/fee/models`

Create fee model.

A fee model is a structure that defines a collection of fees with custom calculations. You can define the method used to calculate the fee, using a fixed value or a percentage. Fee models can be applied to organizations, programs, and accounts. For more information, see the [Fee model](https://developers.pismo.io/pismo-docs/docs/fee-model) guide.

An accumulator fee model requires you call the <a href="https://developers.pismo.io/pismo-docs/reference/post-v1-accumulator-config" target="_blank">Create accumulator configuration</a> endpoint first to define how transaction totals are kept.

Once the fee model is created, it needs to be <a href="https://developers.pismo.io/pismo-docs/reference/attachmentbyaccount">attached to an account</a>, <a href="https://developers.pismo.io/pismo-docs/reference/attachmentbyprogram">attached to a program</a> or <a href="https://developers.pismo.io/pismo-docs/reference/attachmentbytenant">attached to an org</a>.

## Headers

- `Authorization` string, required

## Request body

- FeeModel
  - `model_description` string, required — Model description.
  - `fees` Fee[], required
    - object[] — List of applied fees on this calculation.
      - `type` string — Type of applied fee. For example, fixed, percentage, or any other type.
      - `amount` number — Calculated amount of this fee.
      - `rate` number — When using a percentage fee, this is the percentage rate used for calculating this fee. For example, the value `10` indicates 10%.

## Response `200`

OK

- number — Pismo fee model ID

## Other responses

- `400` — Bad request
- `401` — Access token is missing or invalid
- `500` — Internal server error

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/versions/935b62e16de4/schema)