---
title: "Add internal accounts"
method: POST
path: "/internal_accounts"
tags: ["Internal Accounts"]
---

# Add internal accounts

`POST /internal_accounts`

Add an internal account. 
Note: In production, this action can only be performed by Synctera administrators.

## Headers

- `Idempotency-Key` string

## Request body

- InternalAccountPost
  - `account_number` string — Generated internal account number
  - `account_type` 'ACH_SETTLEMENT' | 'ACH_SUSPENSE' | 'ALLOCATED_SUSPENSE' | 'BANK_DRAFT' | 'BILLING_EXPENSE' | 'BILLING_REVENUE' | 'CARD_AFT_PREFUNDING' | 'CARD_OCT_SETTLEMENT' | 'CARD_SETTLEMENT' | 'CASH_SETTLEMENT' | 'CASH_SUSPENSE' | 'CHECK_SETTLEMENT' | 'DISPUTE_WRITE_OFF_PNL' | 'EFT_CA_SETTLEMENT' | 'EFT_CA_SUSPENSE' | 'EXTERNAL_CARD_AFT_SETTLEMENT' | 'EXTERNAL_CARD_OCT_SETTLEMENT' | 'FEDNOW_SETTLEMENT' | 'FEES' | 'FRAUD_LOSSES' | 'FUNDING_ACCOUNTS' | 'GENERAL_PNL' | 'INTEREST_PAYOUT' | 'INTERNATIONAL_WIRE_SETTLEMENT' | 'IN_STORE_CASH_SETTLEMENT' | 'LOC_INTEREST_INCOME' | 'LOC_INVESTOR_PORTFOLIO' | 'LOC_REPURCHASE' | 'MONEY_IN_AND_OUT' | 'NEGATIVE_BALANCE' | 'NETWORK_ADJUSTMENT' | 'NETWORK_CHARGEBACK' | 'NEW_FUNDING_ACCOUNT' | 'PROVISIONAL_CREDIT_PNL' | 'RESERVE' | 'REWARDS' | 'SC_INVESTOR_PORTFOLIO' | 'SC_REPURCHASE' | 'SYNCTERA_PAY_SUSPENSE' | 'USC_INTEREST_INCOME' | 'USC_INVESTOR_PORTFOLIO' | 'USC_REPURCHASE' | 'WIRE_SETTLEMENT' | 'WIRE_SUSPENSE' | 'WRITE_OFF' — type associated with the internal account.
  - `balances` Balance[] — A list of balances for internal account based on different type
    - `balance` integer, required — balance in ISO 4217 minor currency units. Unit in cents.
    - `type` 'ACCOUNT_BALANCE' | 'ACCRUED_INTEREST_MTD' | 'AVAILABLE_BALANCE' | 'PAYMENTS_RECEIVED_MTD', required — * `ACCOUNT_BALANCE`: The posted balance of the account. For a banking account, e.g. `CHECKING` or `SAVING`, this is a measure of the sum of credits minus debits for all posted transactions. For a lending account, e.g. `CHARGE_SECURED` or `LINE_OF_CREDIT`, this is a measure of the sum of debits minus credits for all posted transactions. This value can be negative. * `AVAILABLE_BALANCE`: The available balance of the account, which is the amount available to spend, or the spending power. For a banking account, e.g. `CHECKING` or `SAVING`, this is a measure of the account balance minus any pending debits. For an unsecured lending account, e.g. `CHARGE_UNSECURED` or `LINE_OF_CREDIT`, this is a measure of available credit, which is its credit limit minus the account balance, minus any pending debits. For a `CHARGE_SECURED` account, it equals the `AVAILABLE_BALANCE` of the linked security account. This value will never be negative. * `ACCRUED_INTEREST_MTD`: The amount of accrued but unposted interest. This value may fluctuate, as new transactions can affect interest amounts. Treat accrued interest as pending for the billing month until it is posted at the end of the billing period. * `PAYMENTS_RECEIVED_MTD`: The amount of payment received to date for the billing month.
  - `bank_account_id` string, uuid — The ID of the bank account associated with this internal account. It will be auto-filled if the account type has only one matching bank account in the system.
  - `bank_routing` string — Bank routing number
  - `creation_time` string, date-time — The date and time the resource was created.
  - `currency` string, required — Account currency or account settlement currency. ISO 4217 alphabetic currency code.
  - `description` string — A user provided description for the current account
  - `gl_type` 'ASSET' | 'EXPENSE' | 'LIABILITY' | 'REVENUE' — What type of general ledger account this internal account represents.
  - `id` string, uuid — Generated ID for internal account
  - `is_system_acc` boolean — Is a system-controlled internal account. When this field is true, this internal account will be reserved exclusively for internal use by the Synctera platform and any internal transfers to or from this internal account will be declined.
  - `last_updated_time` string, date-time — The date and time the resource was last updated.
  - `purpose` 'CORE' | 'PROFIT_AND_LOSS' | 'RESERVE' | 'SETTLEMENT' | 'SUSPENSE' | 'TREASURY' — The purpose of the internal account. On creation, the default is PROFIT_AND_LOSS.
  - `skip_sweeps` boolean — Indicates if transactions of this internal account should be skipped by our sweeps system.
  - `status` 'ACTIVE', required

## Response `201`

The internal account added.

- InternalAccountResponse
  - `tenant` string — The id of the tenant containing the resource. This is relevant for Fintechs that have multiple workspaces.
  - `account_number` string — Generated internal account number
  - `account_type` 'ACH_SETTLEMENT' | 'ACH_SUSPENSE' | 'ALLOCATED_SUSPENSE' | 'BANK_DRAFT' | 'BILLING_EXPENSE' | 'BILLING_REVENUE' | 'CARD_AFT_PREFUNDING' | 'CARD_OCT_SETTLEMENT' | 'CARD_SETTLEMENT' | 'CASH_SETTLEMENT' | 'CASH_SUSPENSE' | 'CHECK_SETTLEMENT' | 'DISPUTE_WRITE_OFF_PNL' | 'EFT_CA_SETTLEMENT' | 'EFT_CA_SUSPENSE' | 'EXTERNAL_CARD_AFT_SETTLEMENT' | 'EXTERNAL_CARD_OCT_SETTLEMENT' | 'FEDNOW_SETTLEMENT' | 'FEES' | 'FRAUD_LOSSES' | 'FUNDING_ACCOUNTS' | 'GENERAL_PNL' | 'INTEREST_PAYOUT' | 'INTERNATIONAL_WIRE_SETTLEMENT' | 'IN_STORE_CASH_SETTLEMENT' | 'LOC_INTEREST_INCOME' | 'LOC_INVESTOR_PORTFOLIO' | 'LOC_REPURCHASE' | 'MONEY_IN_AND_OUT' | 'NEGATIVE_BALANCE' | 'NETWORK_ADJUSTMENT' | 'NETWORK_CHARGEBACK' | 'NEW_FUNDING_ACCOUNT' | 'PROVISIONAL_CREDIT_PNL' | 'RESERVE' | 'REWARDS' | 'SC_INVESTOR_PORTFOLIO' | 'SC_REPURCHASE' | 'SYNCTERA_PAY_SUSPENSE' | 'USC_INTEREST_INCOME' | 'USC_INVESTOR_PORTFOLIO' | 'USC_REPURCHASE' | 'WIRE_SETTLEMENT' | 'WIRE_SUSPENSE' | 'WRITE_OFF' — type associated with the internal account.
  - `balances` Balance[] — A list of balances for internal account based on different type
    - `balance` integer, required — balance in ISO 4217 minor currency units. Unit in cents.
    - `type` 'ACCOUNT_BALANCE' | 'ACCRUED_INTEREST_MTD' | 'AVAILABLE_BALANCE' | 'PAYMENTS_RECEIVED_MTD', required — * `ACCOUNT_BALANCE`: The posted balance of the account. For a banking account, e.g. `CHECKING` or `SAVING`, this is a measure of the sum of credits minus debits for all posted transactions. For a lending account, e.g. `CHARGE_SECURED` or `LINE_OF_CREDIT`, this is a measure of the sum of debits minus credits for all posted transactions. This value can be negative. * `AVAILABLE_BALANCE`: The available balance of the account, which is the amount available to spend, or the spending power. For a banking account, e.g. `CHECKING` or `SAVING`, this is a measure of the account balance minus any pending debits. For an unsecured lending account, e.g. `CHARGE_UNSECURED` or `LINE_OF_CREDIT`, this is a measure of available credit, which is its credit limit minus the account balance, minus any pending debits. For a `CHARGE_SECURED` account, it equals the `AVAILABLE_BALANCE` of the linked security account. This value will never be negative. * `ACCRUED_INTEREST_MTD`: The amount of accrued but unposted interest. This value may fluctuate, as new transactions can affect interest amounts. Treat accrued interest as pending for the billing month until it is posted at the end of the billing period. * `PAYMENTS_RECEIVED_MTD`: The amount of payment received to date for the billing month.
  - `bank_account_id` string, uuid — The ID of the bank account associated with this internal account. It will be auto-filled if the account type has only one matching bank account in the system.
  - `bank_routing` string — Bank routing number
  - `creation_time` string, date-time — The date and time the resource was created.
  - `currency` string, required — Account currency or account settlement currency. ISO 4217 alphabetic currency code.
  - `description` string — A user provided description for the current account
  - `gl_type` 'ASSET' | 'EXPENSE' | 'LIABILITY' | 'REVENUE' — What type of general ledger account this internal account represents.
  - `id` string, uuid — Generated ID for internal account
  - `is_system_acc` boolean — Is a system-controlled internal account. When this field is true, this internal account will be reserved exclusively for internal use by the Synctera platform and any internal transfers to or from this internal account will be declined.
  - `last_updated_time` string, date-time — The date and time the resource was last updated.
  - `purpose` 'CORE' | 'PROFIT_AND_LOSS' | 'RESERVE' | 'SETTLEMENT' | 'SUSPENSE' | 'TREASURY' — The purpose of the internal account. On creation, the default is PROFIT_AND_LOSS.
  - `skip_sweeps` boolean — Indicates if transactions of this internal account should be skipped by our sweeps system.
  - `status` 'ACTIVE', required

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `403` — Forbidden error
- `409` — Resource already exists error
- `500` — Internal server error

---

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