---
title: "Create transaction type"
method: POST
path: "/v1/transaction-types"
tags: ["Transaction types"]
---

# Create transaction type

`POST /v1/transaction-types`

Create a new transaction type. Examples of transaction types include cash-in and cash-out. For the list of transaction types on the Pismo platform, refer to [Standard processing codes](https://developers.pismo.io/pismo-docs/docs/processing-codes-and-transaction-types#standard-processing-codes).

This endpoint generates the [Transaction type created](https://developers.pismo.io/events/docs/transaction-types-creation-1) event. 

For information on creating and managing processing codes and transaction types, refer to [Processing codes and transaction types](https://developers.pismo.io/pismo-docs/docs/processing-codes-and-transaction-types) and [Payments configurations](https://developers.pismo.io/pismo-docs/docs/payments-configurations).

## Request body

- TransactionTypeResult
  - `transaction_type_id` integer, required — Transaction type ID. Certain IDs are reserved by the platform and cannot be used.
  - `description` string, required — Transaction type description
  - `credit` boolean, required — Indicates whether the transaction type is credit (`true`) or debit (`false`).
  - `posted_transaction` boolean, required — Indicates whether transactions are posted on statements (`true`) or not (`false`). Set to `false` for zero balance integrations.

## Response `201`

Created

- TransactionTypeResult
  - `transaction_type_id` integer, required — Transaction type ID. Certain IDs are reserved by the platform and cannot be used.
  - `description` string, required — Transaction type description
  - `credit` boolean, required — Indicates whether the transaction type is credit (`true`) or debit (`false`).
  - `posted_transaction` boolean, required — Indicates whether transactions are posted on statements (`true`) or not (`false`). Set to `false` for zero balance integrations.

## Other responses

- `400` — Bad request
- `409` — Conflict
- `500` — Internal error

---

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