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

## Request

- Base URL: `https://sandbox.pismolabs.io/passport`
- URL: `https://sandbox.pismolabs.io/passport/v2/accounts/{accountId}/bank-accounts/fedwire`
- Auth: none declared. Required headers: `Authorization`

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.dev/pismo/apis/platform-authentication.md) - [All operations](https://skmtc.dev/pismo/apis/platform-authentication/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/platform-authentication/revisions/935b62e16de4?raw)