Add a new Transaction

Adds a new transaction into an existing account.

View as Markdown

POST /v1/transactions

Needs an API key with the write scope.

Parameters

accountId string Required

32-character unique ID of the account that the transaction belongs.
description string Required

Description of the transaction

More parameters

transactionTimestamp integer

Epoch timestamp for the transaction date and time. If both of the fields are provided, transactionTimestamp will be used.
transactionDate string

Datetime with timezone for the transaction date and time.
transactionType string

Type of the transaction. If it is an incoming money, use Money In; if it is an outgoing money, use Money Out
mathcingEntityId string

32-character unique ID of the customer or supplier of the transaction's sender or receiver.
mathcingEntityCode string

User-generated custom customer or supplier code of the transaction's sender or receiver.
amount number

Amount of the transaction. It should be a positive decimal number. eg. 1059.34

Returns

The created transaction.

401: No usable Authorization: Bearer {token} header (1002).
403: The access token is unknown, or lacks the scope this route needs (1001).

POST /v1/transactions

curl -X POST https://api.nuvio.io/v1/transactions \
  -H "Authorization: Bearer $NUVIO_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "description": "Office supplies"
  }'

const response = await fetch('https://api.nuvio.io/v1/transactions', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.NUVIO_API_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "description": "Office supplies"
  }),
});
const { data } = await response.json();

import os
import requests

response = requests.post(
    "https://api.nuvio.io/v1/transactions",
    headers={"Authorization": f"Bearer {os.environ['NUVIO_API_TOKEN']}"},
    json={
        "accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "description": "Office supplies",
    },
)
data = response.json()["data"]

Response

{
  "success": true,
  "errors": null,
  "data": {
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "accountName": "Acme Supplies",
    "description": "Office supplies",
    "transactionTimestamp": 1,
    "transactionDate": "2026-11-05",
    "amount": 100,
    "currency": "USD",
    "transactionType": "Money In",
    "matchedEntity": {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "code": "ACME-01"
    },
    "matchedIncomes": [
      {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "invoiceId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "matchedAmount": 100
      }
    ],
    "matchedExpenses": [
      {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "expenseId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "matchedAmount": 100
      }
    ]
  }
}