# Create a transaction

> POST /transactions

Source: https://docs.trykintsugi.com/reference/2026-10-06/create-a-transaction

POST /transactions

Create a transaction

Create a transaction for the resolved organization. Accepted rather than created: tax is calculated asynchronously, so `totalTaxAmountCalculated` and the per-line `taxItems` populate shortly after this returns. `GET /transactions/{id}` can answer `404` for a short time after this returns. Once the transaction can be read, tax may still be calculating (`processingStatus` `QUEUED`); poll for the amounts rather than treating that first `404` as failure.

Set `type` to `FULL_CREDIT_NOTE` or `PARTIAL_CREDIT_NOTE` and send `originalTransactionId` to reverse a pending, committed, or partially refunded sale. The credit note inherits the original transaction's customer, addresses and source; send the line items to credit in `items`, each carrying the `externalId` of the original line. Reversing a transaction you do not own answers `404`, identical to a transaction that does not exist. Re-POSTing the same credit-note external id against the same parent returns the stored credit note (same as a successful create) rather than a conflict. The same external id against a different parent still conflicts.

Category: Transactions

Request body:
externalId (string, required) - Your stable identifier for the transaction. Re-sending the same one updates the existing transaction rather than creating a second.
date (string, required) - When the transaction occurred. This drives which filing period it lands in, so send the real transaction time, not the time of the call.
type (PublicTransactionTypeEnum) - Kind of transaction. `SALE` records a sale; `FULL_CREDIT_NOTE` or `PARTIAL_CREDIT_NOTE` with `originalTransactionId` reverses a pending, committed, or partially refunded sale. The stored type is derived from the amount credited, so it can differ from the one you send.
  allowed values: SALE, FULL_CREDIT_NOTE, PARTIAL_CREDIT_NOTE, TAX_REFUND, TAX_COLLECTION
originalTransactionId (string) - The sale being reversed. It must be pending, committed, or partially refunded. Required when `type` is a credit-note type and must be omitted for a `SALE`. The credit note inherits the original's customer, addresses and source, so send only the lines to credit in `items`.
currency (PublicCurrencyEnum, required) - ISO-4217 currency of every amount sent.
[truncated, see the reference page]

---

Index of every page: https://docs.trykintsugi.com/llms.txt