---
title: "Create a Transaction"
method: POST
path: "/apps/{appId}/transactions/"
tags: ["Transactions"]
---

# Create a Transaction

`POST /apps/{appId}/transactions/`

## Path parameters

- `appId` integer, required

## Query parameters

- `contact_organization_id` integer
- `contact_person_id` integer
- `account_id` integer
- `cashflow_source_id` integer, required
- `contact_name` string
- `amount` integer — Amount in base currency. Optional if foreign_currency and original_amount are provided
- `original_amount` integer — Amount in foreign currency. Required with foreign_currency if amount is not provided
- `foreign_currency` string — Foreign currency code (ISO 4217). Required with original_amount if amount is not provided
- `method` 'check' | 'transfer' | 'cash' | 'creditcard' | 'automatic_debit' | 'creditnote'
- `received_at` string, date-time, required
- `label` string
- `details` string
- `tags` string
- `metadata` string[], nullable

## Response `200`

Success

- Transaction
  - `id` integer, nullable
  - `contact_organization_id` integer, nullable
  - `contact_person_id` integer, nullable
  - `author_user_id` integer
  - `cashflow_source_id` integer
  - `amount` integer
  - `credit` integer, nullable
  - `debit` integer, nullable
  - `method` integer, nullable
  - `received_at` string, date-time
  - `label` integer
  - `details` integer, nullable
  - `lettered_at` string, date-time, nullable
  - `metadata` unknown[], nullable
    - unknown
  - `tags` string, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `deleted_at` string, date-time

## Other responses

- `404` — Not found

---

[API](https://skmtc.net/sinao/apis/sinao-api.md) · [All operations](https://skmtc.net/sinao/apis/sinao-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinao/sinao-api/versions/436b47b78bf4/schema)