Skip to main content
Use the playground below to try this endpoint directly, or review the OpenAPI details in the right panel. This endpoint lets you make targeted updates to an existing address. All fields are optional — only include what you want to change. Endpoint

​
Updatable fields

​
Add transfer types to an existing address

To add new rails to an existing address (for example, adding ach_credit and same_day_ach_credit to an address), send a PATCH to the same endpoint with additional_transfer_types:
Request
additional_transfer_types is merged into the address’s existing transfer_types. You do not need to resend the full existing list — send only the rails you want to add. Sending a transfer type that is already enabled is idempotent.

​
Add FedNow to an existing recipient

To send FedNow payouts to an existing bank address, such as an RTP recipient, add fednow_credit:
Request
An address with ["ach_credit", "rtp_credit"] becomes ["ach_credit", "rtp_credit", "fednow_credit"]. The address id does not change, so existing references keep working. bank_address and beneficiary_address are not required to add fednow_credit. Confirm fednow_credit is present before sending a payout. See Send FedNow payouts.

​
Set the account holder type

For bank addresses created without account_holder_type, set it once:
Request
It determines the ACH SEC code for payouts to this address (individual → PPD, business → CCD). Once set, it cannot be changed through the API.

​
Error responses

  • 400 — invalid or incompatible transfer types, attempting to archive a pending address, attempting to unarchive a custodial address, invalid status value, or invalid account_holder_type value.
  • 400 account_holder_type_already_set — the address already has a different account_holder_type.
  • 404 — address not found or not owned by the account.
  • 422 fednow_routing_number_not_supported — the address’s routing number does not participate in FedNow. Do not retry.
  • 422 fednow_provider_registration_failed — FedNow registration failed. This can be temporary. Retry the same request after a backoff.
Required scope: addresses:write