---
title: "Modify External Account Link"
method: POST
path: "/modifyExternalAccountLink"
tags: ["External Account Links"]
---

# Modify External Account Link

`POST /modifyExternalAccountLink`

Use the Modify External Account Link endpoint to update an existing external bank account that sends and receives transactions.

Specify only the parameter(s) you wish to modify. Do not pass parameters with `null` or empty values.

## Headers

- `Authorization` string, required

## Request body

- object
  - `accountNo` string, required — The <<glossary:PRN>> to which the external account is linked. Pattern: PRN Example: `"074103447228"`
  - `externalAccountLinkId` string, required — Unique identifier for the specific external account link to modify. Pattern: 1–40 digits Example: `"0359320859384728394827182394832834"`
  - `nickname` string — Display name for the remote account. Not considered to be sensitive data. Pattern: 1–34 characters Example: `"My Savings Account"`
  - `owner` object — Specifies the owner-related fields to update.
    - `address` object — Primary address for the account owner.
      - `line1` string — First line of the address. Pattern: - Default: 1-105 characters with at least one non-whitespace character - FEDWIRE: 1-105 characters, limited to alphanumeric and special characters
      - `line2` string — Second line of the address (apartment, suite, etc.). Pattern: - Default: 1-35 characters with at least one non-whitespace character - FEDWIRE: 1-35 characters, limited to alphanumeric and special characters
      - `city` string — City name. Pattern: - Default: 1-35 characters with at least one non-whitespace character - FEDWIRE: 1-35 characters, limited to alphanumeric and special characters
      - `state` string — State or province code. Pattern: - Default: 2-35 characters with at least one non-whitespace character. For US addresses, typically 2-letter state code (e.g., 'NY', 'CA') - FEDWIRE: 2-35 characters, limited to alphanumeric and special characters
      - `zipCode` string — Postal code or ZIP code. Pattern: - Default: 1-15 characters with at least one non-whitespace character. For US addresses, typically 5-digit ZIP code (e.g., '11201') - FEDWIRE: 1-15 characters, limited to alphanumeric and special characters
      - `country` string — Country code following ISO 3166-1 alpha-2 format. Pattern: Exactly 2 uppercase letters. Examples: 'US' (United States), 'MX' (Mexico)
    - `consumerFirstName` string — First name of the individual who owns the account. Pattern: 1-40 characters Example: `"Jane"`
    - `consumerLastName` string — Last name of the individual who owns the account. Pattern: 1-40 characters Example: `"Doe"`
    - `businessName` string — Legal name of the business that owns the account. Pattern: 1-40 characters Example: `"ABC Corporation"`
  - `details` object — Base class for modifiable account details
    - `type` 'BANK' | 'CARD', required — Type of external account being linked.
  - `validation` object — Specifies the validation information to update.
    - `type` 'CLIENT' | 'LEGACY' | 'CARD' | 'FINICITY' | 'NONE' | 'MICRO_ENTRY' — Validation method for the external account. Example: CLIENT
    - `status` 'PENDING' | 'FAILED' | 'PASSED' | 'NO_VALIDATION' — Validation status of the external account. Example: VERIFIED

## Response `200`

Successful Response

- object
  - `externalAccountLinkId` string, required — Unique identifier that identifies the external account link in the system.

## Other responses

- `400` — Bad Request
- `401` — No valid API credentials provided.
- `403` — The provided API credential does not allow this operation.
- `404` — Not Found
- `422` — Validation Error
- `429` — Too many requests.
- `500` — Internal Server Error
- `502` — Bad Gateway.
- `503` — Service Unavailable.

---

[API](https://skmtc.net/galileo-ft/apis/program-api.md) · [All operations](https://skmtc.net/galileo-ft/apis/program-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/galileo-ft/program-api/versions/bcd728f97a18/schema)