---
title: "Ingest accounts"
method: POST
path: "/connector/users/{externalUserId}/accounts"
tags: ["ENTERPRISE", "Connector.Account", "MULTI_TENANT"]
---

# Ingest accounts

`POST /connector/users/{externalUserId}/accounts`

Takes a list of accounts and the corresponding user ID.

## Path parameters

- `externalUserId` string, required

## Request body

- AccountListEntity — The accounts.
  - `accounts` AccountEntity[], required — The accounts.
    - `availableCredit` number, double — The available credit of the account. Available credit is defined as the amount the customer has left to spend at this time. As such, it decreases with every reservation or transaction. For accounts without credit, this is always zero.
    - `balance` number, double, required — The booked balance of the account. Currency is taken from the user's profile.
    - `closed` boolean — The closed state of the account.
    - `exclusion` 'PFM_AND_SEARCH, PFM_DATA, NONE' — The type of features to exclude. PFM_AND_SEARCH will exclude the accounts transactions from categorization, PFM features, and search result. PFM_DATA will exclude the accounts transactions from categorization and PFM features.
    - `externalId` string, required — External identifier for the account.
    - `flags` string[] — A list of flags specifying attributes on an account.
    - `name` string, required — The account name.
    - `number` string, required — The account number.
    - `payload` object — This property is deprecated and disabled as default. For customers where it is still enabled observe that the payload may not exceed 200 chars. Please contact your Technical Project Manager if your use case depend on this property.
    - `reservedAmount` number, double — The currently reserved amount of the account.
    - `type` 'CHECKING, SAVINGS, INVESTMENT, MORTGAGE, CREDIT_CARD, LOAN, PENSION, OTHER, EXTERNAL', required — The account type.

## Response `204`

Accounts created.

## Other responses

- `400` — The payload does not pass validation.
- `401` — User not found, has no credentials, or has more than one abstract credentials.
- `409` — Account already exists.

---

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