Create transaction

POST

/api-v1/transactions

Transactions

Manually create a new transaction.

Use this endpoint to add transactions that are not imported from bank statements.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Transaction created

Body

🟠400BadRequest

Request Example

Shell

JavaScript

Java

Swift

cURL

Create an expenseCreate income

curl --location --request POST 'https://gvazyknvkqdeuzmrnuwu.supabase.co/functions/v1/api-v1/transactions' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bank_account_id": "550e8400-e29b-41d4-a716-446655440000",
    "transaction_date": "2025-01-15",
    "description": "Office Supplies - Staples",
    "amount": -250,
    "currency_code": "MXN",
    "category": "Office Supplies",
    "accounting_category": "Administrative Expenses",
    "cash_flow_category": "operations",
    "merchant_name": "Staples",
    "tags": [
        "supplies",
        "office"
    ]
}'

Response Example

201 - Success

{
    "success": true,
    "data": {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "transaction_date": "2025-01-15",
        "posted_date": "2025-01-15",
        "description": "Office Supplies - Staples",
        "original_description": "Office Supplies - Staples",
        "amount": -250,
        "currency_code": "MXN",
        "exchange_rate": 1,
        "category": "Office Supplies",
        "accounting_category": "Administrative Expenses",
        "cash_flow_category": "operations",
        "merchant_name": "Staples",
        "status": "pending",
        "is_reconciled": false,
        "ai_confidence_score": null,
        "tags": [
            "supplies",
            "office"
        ],
        "bank_account_id": "550e8400-e29b-41d4-a716-446655440000",
        "bank_statement_id": null,
        "created_at": "2025-01-15T10:30:00Z",
        "updated_at": "2025-01-15T10:30:00Z"
    }
}

Modified at 2025-12-30 00:32:01

List transactions

Get transaction details