---
title: "POST /v1/accounts/{account_id}/events"
method: POST
path: "/v1/accounts/{account_id}/events"
tags: ["Events"]
---

# POST /v1/accounts/{account_id}/events

`POST /v1/accounts/{account_id}/events`

## Path parameters

- `account_id` string, required

## Headers

- `Fuse-Client-Id` string, required
- `Fuse-Api-Key` string, required

## Request body

- AddAccountEventsRequest
  - `events` union[], required
    - union
      - object
        - `id` string, required — ID of the transaction
        - `event_type` 'external_transaction', required
        - `status` 'pending' | 'posted', required
        - `amount` number, required — Amount in cents associated with the transaction. Use positive values to represent money going out and negative to represent money going in.
        - `country_code` string
        - `iso_currency_code` string, required — The ISO-4217 currency code.
        - `transaction_type` 'ach' | 'adjustment' | 'atm' | 'bank_charge' | 'bill_payment' | 'card_payment' | 'cash' | 'cashback' | 'charge' | 'cheque' | 'credit' | 'debit' | 'deposit' | 'digital_payment' | 'direct_debit' | 'fee' | 'in_store' | 'interest' | 'online' | 'other' | 'payment' | 'purchase' | 'standing_order' | 'transaction' | 'transfer' | 'wire' | 'withdrawal' — Type of the transaction, ie loan
        - `transaction_description` string
        - `transaction_owner_type` 'consumer' | 'business'
        - `merchant_name` string, required
        - `timestamp` string, required — Datetime of the transaction In ISO-8601 format
        - `balance` number — The running balance of the account after the transaction has occurred, in cents
      - object
        - `id` string, required — ID of the transaction
        - `event_type` 'in_app_transaction', required
        - `status` 'pending' | 'succeeded' | 'failed', required
        - `amount` number, required
        - `iso_currency_code` string, required — The ISO-4217 currency code.
        - `transaction_type` TransactionType — unresolved $ref
        - `merchant_name` string, required
        - `timestamp` string, required — Datetime of the transaction In ISO-8601 format
        - `balance` number — The running balance of the account after the transaction has occurred, in cents.
      - object
        - `event_type` 'updated_balance', required
        - `iso_currency_code` string, required — The ISO-4217 currency code.
        - `timestamp` string, required — Datetime that the balance is accurate for In ISO-8601 format
        - `available` number, nullable — The current balance of the account factoring in pending transactions.
        - `current` number, nullable — The current balance of the account without factoring in pending transactions.

## Response `200`

Successful response

- AddAccountEventsResponse
  - `message` string, required — Response message
  - `request_id` string, required — An identifier that is exclusive to the request and can serve as a means for investigating and resolving issues.

---

[API](https://skmtc.net/letsfuse/apis/sessions.md) · [All operations](https://skmtc.net/letsfuse/apis/sessions/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/letsfuse/sessions/revisions/816323e226dc/schema)