---
title: "Register Fedwire account"
method: POST
path: "/v2/accounts/{accountId}/bank-accounts/fedwire"
tags: ["Bank accounts"]
---

# Register Fedwire account

`POST /v2/accounts/{accountId}/bank-accounts/fedwire`

Register a new Fedwire bank account.

Fedwire is a real-time gross settlement funds transfer system operated by the Federal Reserve Banks in the United States.

To read about Pismo's banking offerings, see [Banking overview](https://developers.pismo.io/pismo-docs/docs/banking-overview).

This endpoint generates a [Bank account registered](https://developers.pismo.io/events/docs/intl-bankaccounts-intl-bankaccount-register-1) event.

## Path parameters

- `accountId` string, required

## Headers

- `Authorization` string, required

## Request body

- IntlbankaccountsIntlBankAccountFedWireRequest
  - `scheme` IntlbankaccountsFedWireScheme, required
    - `account_number` string, required — Account number
    - `routing_number` string, required — A routing number is a nine-digit number used to identify a financial institution in the United States. It is also known as an ABA (American Bankers Association) number.
  - `metadata` Metadata — A set of key-value pairs used to store custom data or additional information.<br> **Note**: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to [Get started with Pismo APIs](https://developers.pismo.io/pismo-docs/reference/get-started-with-pismo-apis).

## Response `201`

Response body

- IntlbankaccountsIntlBankAccountFedWireResponse
  - `account_id` integer — Account ID
  - `creation_datetime` string, date-time — Account creation date time displayed in ISO 8601 format `2023-04-12T23:20:50.52Z`.
  - `metadata` Metadata — A set of key-value pairs used to store custom data or additional information.<br> **Note**: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to [Get started with Pismo APIs](https://developers.pismo.io/pismo-docs/reference/get-started-with-pismo-apis).
  - `scheme` IntlbankaccountsFedWireScheme, required
    - `account_number` string, required — Account number
    - `routing_number` string, required — A routing number is a nine-digit number used to identify a financial institution in the United States. It is also known as an ABA (American Bankers Association) number.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `500` — Internal Server

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)