Store a new transaction

Creates a new transaction. The data required can be submitted as a JSON body or as a list of parameters.

post/v1/transactions

Headers

X-Trace-Idstring uuid

Example:40c71bbb-c676-4f24-83cf-cc725d7d7a00

Unique identifier associated with this request.

Request body

error_if_duplicate_hashboolean

Break if the submitted transaction exists already.

apply_rulesboolean

Whether or not to apply rules when submitting transaction.

fire_webhooksboolean

Whether or not to fire the webhooks that are related to this event.

group_titlestring string nullable

Title of the transaction if it has been split in more than one piece. Empty otherwise.

Example request

{
  "fire_webhooks": true,
  "group_title": "Split transaction title.",
  "transactions": [
    {
      "type": "withdrawal",
      "date": "2026-08-01T00:00:00+00:00",
      "amount": "123.45",
      "description": "Vegetables",
      "currency_id": "12",
      "currency_code": "EUR",
      "foreign_amount": "123.45",
      "foreign_currency_id": "17",
      "foreign_currency_code": "USD",
      "budget_id": "4",
      "budget_name": "Groceries",
      "category_id": "43",
      "category_name": "Groceries",
      "source_id": "2",
      "source_name": "Checking account",
      "destination_id": "2",
      "destination_name": "Buy and Large",
      "bill_id": "112",
      "bill_name": "Monthly rent",
      "tags": [
        "Barbecue preparation"
      ],
      "notes": "Some example notes"
    }
  ]
}

Response

New transaction stored(s), result in response.

Changes

No recorded changes to this endpoint across all 1 revision of this API.