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

# Delete Accounts

`POST /data/v2/connector/accounts:delete`

Deletes existing account in the Tink platform that was originally created via the data v2 Connector.

## Request body

- TinkGoldenreceiverDeleteAccountRequest — Request for accounts deletion.
  - `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.

## 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

- `204` — Delete 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)