---
title: "Add a new fee"
method: POST
path: "/api/v2/organizations/{orgSlug}/fees"
tags: ["Fees"]
---

# Add a new fee

`POST /api/v2/organizations/{orgSlug}/fees`

Add a new fee 

 Required scopes: `flex.community.fees.create`

## Path parameters

- `orgSlug` string, required

## Query parameters

- `shouldUseCoins` boolean

## Request body

- AddFeeDto
  - `properties` object — An object that contains all custom properties that can be applied to the item.
  - `name` string, required — The name of the fee.
  - `issueDate` string, required — The issue date of the fee.
  - `location` string, required — The _id of the location of the fee.
  - `plan` string, required — The _id of the plan of the fee.
  - `price` number, required — The price of the fee.
  - `member` string — The _id of the member associated with the fee.
  - `company` string — The _id of the company associated with the fee.
  - `quantity` number — The quantity of the fee. If ommited, the quantity will be set to 1.
  - `shouldBillInAdvance` boolean — If true, the one-off charge is billed in advance (respecting its date). By default one-off charges are not billed in advance.
  - `isPersonal` boolean — If true, the one-off charge is billed to the assigned member and not to the company.

## Response `201`

- FeeResultDto
  - `properties` object — An object that contains all custom properties that can be applied to the item.
  - `_id` string — The _id of the fee.
  - `name` string — The name of the fee.
  - `price` number — The unit price of the item described by the fee.
  - `quantity` number — The quantity described by the one-off charge.
  - `company` string — The _id of the company that the fee is associated with.
  - `member` string — The _id of the member that the fee is associated with.
  - `location` string — A reference to the location the fee is issued for.
  - `plan` string — A reference to the price plan assigned to the fee. It is used to determine the sales account when generating an invoice.
  - `planType` 'Plan' | 'ResourceRate' — The type of the plan assigned to the fee.
  - `issueDate` string — The date the fee was issued.
  - `status` 'approved' | 'awaiting_approval' — The status of the fee.
  - `discount` string — A reference to a discount definition.
  - `discountAmount` number — Manually granted discount for the specific fee.
  - `calculatedDiscountAmount` number — The actual discount amount coming from a discount defintion or from a manually granted discount.
  - `discountedPrice` number — The final fee unit price after granting the discount.
  - `isRefundable` boolean — If true, the one-off charge is counted as deposit and can be refunded later on.
  - `isPersonal` boolean — If true, the one-off charge is billed to the assigned member and not to the company.
  - `shouldBillInAdvance` boolean — If true, the one-off charge is billed in advance (respecting its date). By default one-off charges are not billed in advance.
  - `shouldUseCoins` boolean — In order for a fee to use coins you need to set this to true. By default it's set to false.
  - `coins` FeeCoinResultDto[] — The coins used for the fee.
    - `_id` string — The _id of the coin used for the fee.
    - `count` number — The count of the coins used for the fee.
  - `payment` FeePaymentDto
    - `_id` string — The _id of the payment associated with the fee. Appears, if a fee has been invoiced
    - `status` 'not_paid' | 'invoiced' | 'paid' | 'refunded' | 'waived' — The status of the fee in terms of billing.
    - `creditNote` string — The _id of the credit note associated with the fee. Appears, if a fee was credited.
  - `source` string — The source of the fee.
  - `createdAt` string, date-time — The date when the fee has been created.
  - `createdBy` string — The user that created the fee.
  - `modifiedAt` string, date-time — The user that did the last modification to the fee. If no update is made this field will match the "createdBy" field.
  - `modifiedBy` string — The user that last updated the fee.

---

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