---
title: "Create payment term"
method: POST
path: "/payment-terms"
tags: ["Payment Terms"]
---

# Create payment term

`POST /payment-terms`

Create a new payment term configuration in your organization

## Request body

- PaymentTermInput
  - `name` string, required — Payment term name
  - `description` string — Payment term description or notes
  - `days` integer — Number of days until payment is due
  - `quickPayFee` number, float — Quick pay fee percentage (e.g., 0.05 for 5%)
  - `apOnly` boolean — Whether this payment term is for accounts payable only
  - `doNotUse` boolean — Flag to prevent using this payment term for new transactions
  - `key` string — Client-defined reference identifier

## Response `201`

Payment term created successfully

- PaymentTerm
  - `id` string, uuid, required — Unique payment term identifier
  - `name` string, required — Payment term name
  - `description` string, nullable — Payment term description or notes
  - `days` integer, nullable — Number of days until payment is due
  - `quickPayFee` number, float, nullable — Quick pay fee percentage (e.g., 0.05 for 5%)
  - `apOnly` boolean, nullable — Whether this payment term is for accounts payable only
  - `doNotUse` boolean, nullable — Flag to prevent using this payment term for new transactions
  - `key` string, nullable — Client-defined reference identifier
  - `createdAt` string, date-time, required — When the payment term was created
  - `updatedAt` string, date-time, required — When the payment term was last updated
  - `deletedAt` string, date-time, nullable — When the payment term was soft deleted (null if active)

## Other responses

- `400` — Bad request - invalid input
- `401` — Unauthorized - invalid or missing access token
- `422` — Validation error - invalid field values
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/mvmnt/apis/mvmnt-api.md) · [All operations](https://skmtc.net/mvmnt/apis/mvmnt-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mvmnt/mvmnt-api/revisions/c44e5e7a4256/schema)