---
title: "Update Accounts"
method: PATCH
path: "/data/v2/connector/accounts"
tags: ["Data v2.Connector.Accounts", "REGION.US", "MULTI_TENANT"]
---

# Update Accounts

`PATCH /data/v2/connector/accounts`

Updates existing accounts in the Tink platform that were originally created via the data v2 Connector.

## Request body

- TinkGoldenreceiverUpdateAccountsRequest — Request for accounts update.
  - `accounts` TinkGoldenreceiverUpdateAccountsRequestAccountUpdate[] — The list of accounts to be updated.
    - `accountName` string — The human-readable name of the account. Intended to be displayed to the user in the account list.
    - `balances` TinkGoldenreceiverBalance — Represents the balance of an account.
      - `availableBalanceIncludingCredit` string — The current available balance of the account, including any available credit. The amount must be specified in minor units of the account currency (e.g., cents for EUR) without a decimal separator. Currently, only currencies with two decimal places are supported.
      - `bookedBalance` string — The booked balance of the account. Represents the balance after all posted transactions have been applied, excluding pending transactions. The amount must be specified in minor units of the account currency (e.g., cents for EUR) without a decimal separator. Currently, only currencies with two decimal places are supported.
      - `creditLimit` string — The credit limit assigned to the account. Applicable for accounts with an overdraft facility or credit accounts. The amount must be specified in minor units of the account currency (e.g., cents for EUR) without a decimal separator. Currently, only currencies with two decimal places are supported.
    - `displayAccountNumber` string — The masked (required for PAN) or display version of the account number.
    - `externalAccountId` string, required — The unique external account identifier specified by the customer when ingesting the account.
    - `externalUserId` string, required — The external user identifier specified by the customer when creating the user to whom this account belongs.
    - `type` 'DEFAULT' | 'CHECKING' | 'SAVINGS' | 'CREDIT_CARD', required — Enum for account types. - DEFAULT: Default account type. - CHECKING: Checking account. - SAVINGS: Savings account. - CREDIT_CARD: Credit card account.

## Response `200`

A successful response.

- TinkGoldenreceiverAccountResponse — Response with account validation errors.
  - `users` TinkGoldenreceiverAccountResponseUserIngestionStatus[] — Available users.
    - `exceptions` TinkGoldenreceiverAccountResponseException[] — Aggregated errors for this particular user, if any occurred.
      - `externalAccountId` string — The external account identifier specified by the customer when ingesting the account.
      - `fieldPath` string — The path of the field that failed validation or ingestion.
      - `reasons` TinkGoldenreceiverAccountResponseExceptionReason[] — Detailed error reason.
        - `errorType` 'OTHER' | 'DUPLICATED_EXTERNAL_ACCOUNT_ID' | 'EXISTING_EXTERNAL_ACCOUNT_ID' | 'MISSING_EXTERNAL_ACCOUNT_ID' | 'EXTERNAL_ACCOUNT_ID_NOT_EXISTS' | 'EXTERNAL_ACCOUNT_ID_TOO_LONG' | 'MISSING_EXTERNAL_USER_ID' | 'EXTERNAL_USER_ID_TOO_LONG' | 'EXTERNAL_USER_ID_NOT_EXISTS' | 'MISSING_CURRENCY_CODE' | 'INVALID_CURRENCY_CODE' | 'INVALID_BALANCE' | 'MISSING_ACCOUNT_TYPE' | 'INVALID_ACCOUNT_TYPE' | 'ACCOUNT_NOT_MAPPED_PROPERLY' | 'ACCOUNT_FAILED_TO_INGEST' | 'ACCOUNT_FAILED_TO_UPDATE' | 'ACCOUNT_FAILED_TO_DELETE' | 'MISSING_ACCOUNTS_FOR_USERID' — - OTHER: Any other reason of an error. - DUPLICATED_EXTERNAL_ACCOUNT_ID: The same externalAccountId is repeated for the same externalUserId in this appId. Each externalAccountId for given externalUserId must be unique. - EXISTING_EXTERNAL_ACCOUNT_ID: Provided externalAccountId already exists for this account from a prior ingest. - MISSING_EXTERNAL_ACCOUNT_ID: No external accountId is provided. - EXTERNAL_ACCOUNT_ID_NOT_EXISTS: Account with provided externalAccountId is not created for this appId. The operation cannot modify or delete non-existent account. - EXTERNAL_ACCOUNT_ID_TOO_LONG: External accountId length exceeds the maximum allowed amount of 255 characters. - MISSING_EXTERNAL_USER_ID: UserId is missing or null. It is required for every account. - EXTERNAL_USER_ID_TOO_LONG: External userId length exceeds the maximum allowed amount of 255 characters. - EXTERNAL_USER_ID_NOT_EXISTS: User with provided externalUserId is not created for this appId. The operation cannot attach accounts or transactions to an unknown app user. - MISSING_CURRENCY_CODE: Currency code is missing or null; It should be 3-letter ISO 4217 currency code. - INVALID_CURRENCY_CODE: Currency code is invalid. It should be 3-letter ISO 4217 currency code. - INVALID_BALANCE: Balance is invalid. - MISSING_ACCOUNT_TYPE: Account type is missing. Available values: `CHECKING`, `SAVINGS`, `CREDIT_CARD`. - INVALID_ACCOUNT_TYPE: Account type is invalid. Available values: `CHECKING`, `SAVINGS`, `CREDIT_CARD`. - ACCOUNT_NOT_MAPPED_PROPERLY: For some reason account was not parsed properly. - ACCOUNT_FAILED_TO_INGEST: Account failed to be ingested. - ACCOUNT_FAILED_TO_UPDATE: Account failed to be updated. - ACCOUNT_FAILED_TO_DELETE: Account failed to be deleted. - MISSING_ACCOUNTS_FOR_USERID: User does not have accounts.
        - `fieldName` string — Name of the field associated with the error.
        - `message` string — Description of what went wrong.
    - `externalUserId` string — The external user identifier specified by the client.

## Other responses

- `202` — Update request accepted
- `400` — The request does not pass validation. Check the error message or the documentation of each field for more information.
- `401` — Authorization token is missing, or not valid
- `403` — You are not allowed to access the requested resource
- `default` — An unexpected error response.

---

[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)