# Create a transaction

> POST /transactions

Source: https://docs.trykintsugi.com/reference/2026-07-21/create-a-transaction

POST /transactions

Create a transaction

Create a transaction for the resolved organization. Accepted rather than created: the transaction is recorded immediately, and tax is calculated asynchronously, so `totalTaxAmountCalculated` and the per-line `taxItems` populate shortly after this returns. For the same reason the returned `id` is not immediately fetchable: `GET /transactions/{id}` answers `404` until processing completes, so poll it rather than treating the first `404` as failure.

Set `type` to `FULL_CREDIT_NOTE` or `PARTIAL_CREDIT_NOTE` and send `originalTransactionId` to reverse a committed 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 committed 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 committed sale being reversed. 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 (CurrencyEnum, required) - ISO-4217 currency of every amount sent.
  allowed values: AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD (and 150 more, see the reference page)
totalAmount (string) - Total transaction amount.
[truncated, see the reference page]

---

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