This endpoint is the Direct bank entry path for creating external off-chain bank addresses. Use it when you already have the bank account details (account number, routing number) and need wire, ach_credit, same_day_ach_credit, or fednow_credit (on accounts with FedNow enabled).
RTP payouts (rtp_credit) ended on October 30, 2026. FedNow (fednow_credit) replaces RTP for instant USD payouts. Requests that still send rtp_credit return 400 invalid_transfer_types on address creation or 400 invalid_transfer_type on transfer creation. To switch, follow Migrate from rtp_credit to fednow_credit. For recipient banks that do not participate in FedNow, use same_day_ach_credit or wire.
Address fields are conditional. bank_address and beneficiary_address are required when transfer_types includes wire. They are optional for ach_credit, same_day_ach_credit, and fednow_credit. For addresses without wire, do not provide placeholder or generic bank addresses. Omit these fields unless you have accurate values.
For a full comparison of both external bank address creation paths, see External bank addresses.
Direct bank entry field requirements
For Direct bank entry, required fields depend on the transfer types you request.
Field
ACH Credit
Same Day ACH Credit
FedNow Credit
Wire
owner
Required
Required
Required
Required
account_number
Required
Required
Required
Required
routing_number
Required
Required
Required
Required
account_type
Required
Required
Required
Required
transfer_types
Required
Required
Required
Required
bank_address
Optional
Optional
Optional
Required
beneficiary_address
Optional
Optional
Optional
Required
If transfer_types includes wire, wire requirements apply. For addresses without wire, omit bank_address and beneficiary_address unless you have accurate values. Send account_number and routing_number as strings so leading zeros are preserved.
Direct bank entry examples
ACH Credit (ach_credit, same_day_ach_credit)
Omit bank_address and beneficiary_address for ACH-only addresses.
Do not assume fednow_credit is added asynchronously. Retrieve the address and confirm status is active and transfer_types includes fednow_credit before you send a payout. See Send FedNow payouts.
FedNow errors
Brale returns these errors with the standard error envelope:
Status
type
Meaning
Retry
422
fednow_routing_number_not_supported
The routing number does not participate in FedNow.
No. Use another rail.
422
fednow_provider_registration_failed
FedNow registration failed. This can be temporary.
Yes. Retry with the same Idempotency-Key and body after a backoff.
400
invalid_transfer_types
transfer_types includes a value the address cannot use, most often rtp_credit. The detail reads Invalid transfer types; Address transfer types must be compatible chains.
{ "type": "fednow_routing_number_not_supported", "detail": "The routing number does not support FedNow.", "status": 422}
Disabled bank accounts
If the bank account matches an external address that Brale disabled after a return, Brale returns 422external_address_disabled and does not create a new address. Contact support to re-enable the existing address. See Troubleshooting.
Wire (wire)
Wire-capable addresses require both bank_address and beneficiary_address.
If you include wire in transfer_types, both bank_address and beneficiary_address are required, even if the same address also includes ACH or FedNow rails.
Use the playground below to try this endpoint directly, or review the OpenAPI details in the right panel.
Authorizations
Authorization
string
header
required
Use the Bearer token returned from the Auth endpoint via OAuth2 client_credentials flow. Include the token in the "Authorization: Bearer " header.
Headers
Idempotency-Key
string
required
A unique string used to prevent duplicate operations. Each POST request must use a new idempotency key. Use a UUIDv4 string. Example: idemp-123e4567-e89b-12d3-a456-426614174000
Path Parameters
account_id
string<ksuid>
required
The ID of the account
Pattern: ^[a-zA-Z0-9]{27}$
Example:
"2VcUIIsgARwVbEGlIYbhg6fGG57"
Body
application/json
CreateExternalBlockchainAddressRequest
CreateExternalFinancialInstitutionRequest
name
string | null
required
Example:
"Company External EVM Address"
address
string
required
Example:
"0xb518d4d6221d9a41d23d71cbce8e106e7aab8f9b"
transfer_types
string[]
required
Response
External address successfully created
The full external address object returned by POST /accounts/{account_id}/addresses/external.
id
string<ksuid>
Pattern: ^[a-zA-Z0-9]{27}$
Example:
"2VcUIIsgARwVbEGlIYbhg6fGG57"
name
string | null
Example:
"checking 7890"
owner
string
Example:
"Jane Doe"
status
string
Example:
"active"
ownership
string
Example:
"customer-owned"
account_holder_type
enum<string> | null
Whether the bank account is held by an individual or a business. null if it was not set.
Available options:
individual,
business
Example:
"business"
date_of_birth
string | null
Recipient's date of birth, masked to the year (YYYY-**-**). Brale never returns the full date. null if no date of birth is on file.
US street address as returned in external address responses. Includes country, unlike the request USStreetAddress schema.
Show child attributes
created
string<date-time>
Example:
"2026-06-02T20:01:02.226850Z"
transfer_types
string[]
Example:
["ach_credit"]
account_number
string
Returned masked (e.g. ****7890).
Example:
"****7890"
account_type
enum<string>
Available options:
checking,
savings
Example:
"checking"
needs_update
boolean
Example:
false
last_updated
string<date-time>
Example:
"2026-06-02T20:01:03.321461Z"
routingNumber
string
Note: this single field is currently returned in camelCase (routingNumber) while all other fields use snake_case.
Example:
"063108680"
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Brale","description":"API documentation for issuing, moving, and managing stablecoins on any blockchain with Brale.","colors":{"primary":"#000000","light":"#6938EF","dark":"#18181B"},"logo":{"light":"https://mintcdn.com/brale/8ZhoPWIKA3trPz7_/images/brale/brale-logo-light.svg?fit=max\u0026auto=format\u0026n=8ZhoPWIKA3trPz7_\u0026q=85\u0026s=9d75182cc1a672349f431ab9462b2b14","dark":"https://mintcdn.com/brale/8ZhoPWIKA3trPz7_/images/brale/brale-logo-dark.svg?fit=max\u0026auto=format\u0026n=8ZhoPWIKA3trPz7_\u0026q=85\u0026s=b440c6595e79456e4bec0a5be2bb6b8e"},"favicon":"https://mintcdn.com/brale/8ZhoPWIKA3trPz7_/favicon.svg?fit=max\u0026auto=format\u0026n=8ZhoPWIKA3trPz7_\u0026q=85\u0026s=5ea8e718e80214027ad6dd92fd6a4116","navbar":{"links":[],"primary":{"type":"button","label":"Dashboard","href":"https://app.brale.xyz"}},"footer":{"socials":{"github":"https://github.com/Brale-xyz"}},"seo":{"metatags":{"canonical":"https://docs.brale.xyz","og:site_name":"Brale"},"indexing":"navigable"},"integrations":{"ga4":{"measurementId":"G-ZM1CBNJ9KC"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"API Keys","icon":"key","href":"https://app.brale.xyz"},{"anchor":"API Logs","icon":"database","href":"https://app.brale.xyz/api?tab=activity"},{"anchor":"Changelog","icon":"clock-rotate-left","href":"/changelog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"brale","hasAudioNarration":false,"actualSubdomain":"brale","customDomains":["docs.brale.xyz"],"gitSource":{"type":"github","owner":"brale-xyz","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":false,"issues":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afdd32e1a1d099aefc612b9","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"API reference","count":42},{"language":"default","tag":"Guides","count":24},{"language":"default","tag":"API Docs","count":20},{"language":"default","tag":"Workflows","count":18},{"language":"default","tag":"Information","count":15},{"language":"default","tag":"Webhooks","count":13},{"language":"default","tag":"Key concepts","count":10},{"language":"default","tag":"Tokenization","count":9},{"language":"default","tag":"Accounts","count":6},{"language":"default","tag":"Addresses","count":6}]},"assistantConfig":{"enableAskAiButton":true,"enableStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"[email protected]","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/brale/create-address","slug":"/api-reference/brale/create-address","pageMetadata":{"title":"Create a new external address","description":"Create an external bank address with account and routing numbers for wire, ACH credit, and FedNow payouts using the Direct bank entry path.","openapi":"POST /accounts/{account_id}/addresses/external","href":"/api-reference/brale/create-address"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create an external bank address with account and routing numbers for wire, ACH credit, and FedNow payouts using the Direct bank entry path.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`This endpoint is the `,_jsx(_components.strong,{children:`Direct bank entry`}),` path for creating external off-chain bank addresses. Use it when you already have the bank account details (account number, routing number) and need `,_jsx(_components.code,{children:`wire`}),`, `,_jsx(_components.code,{children:`ach_credit`}),`, `,_jsx(_components.code,{children:`same_day_ach_credit`}),`, or `,_jsx(_components.code,{children:`fednow_credit`}),` (on accounts with FedNow enabled).`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`RTP payouts (`,_jsx(_components.code,{children:`rtp_credit`}),`) ended on October 30, 2026. FedNow (`,_jsx(_components.code,{children:`fednow_credit`}),`) replaces RTP for instant USD payouts. Requests that still send `,_jsx(_components.code,{children:`rtp_credit`}),` return `,_jsx(_components.code,{children:`400 invalid_transfer_types`}),` on address creation or `,_jsx(_components.code,{children:`400 invalid_transfer_type`}),` on transfer creation. To switch, follow `,_jsxs(_components.a,{href:`/guides/fednow-outbound#migrate-from-rtp_credit-to-fednow_credit`,children:[`Migrate from `,_jsx(_components.code,{children:`rtp_credit`}),` to `,_jsx(_components.code,{children:`fednow_credit`})]}),`. For recipient banks that do not participate in FedNow, use `,_jsx(_components.code,{children:`same_day_ach_credit`}),` or `,_jsx(_components.code,{children:`wire`}),`.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`This endpoint does `,_jsx(_components.strong,{children:`not`}),` support `,_jsx(_components.code,{children:`ach_debit`}),`. If you need ACH debit, use the `,_jsx(_components.a,{href:`/api-reference/brale/create-plaid-link-token`,children:`Plaid-linked bank account flow`}),` instead.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Address fields are conditional. `,_jsx(_components.code,{children:`bank_address`}),` and `,_jsx(_components.code,{children:`beneficiary_address`}),` are `,_jsxs(_components.strong,{children:[`required when `,_jsx(_components.code,{children:`transfer_types`}),` includes `,_jsx(_components.code,{children:`wire`})]}),`. They are `,_jsx(_components.strong,{children:`optional`}),` for `,_jsx(_components.code,{children:`ach_credit`}),`, `,_jsx(_components.code,{children:`same_day_ach_credit`}),`, and `,_jsx(_components.code,{children:`fednow_credit`}),`. For addresses without `,_jsx(_components.code,{children:`wire`}),`, do not provide placeholder or generic bank addresses. Omit these fields unless you have accurate values.`]})}),`\n`,_jsxs(_components.p,{children:[`For a full comparison of both external bank address creation paths, see `,_jsx(_components.a,{href:`/key-concepts/external-bank-addresses`,children:`External bank addresses`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`direct-bank-entry-field-requirements`,children:`Direct bank entry field requirements`}),`\n`,_jsx(_components.p,{children:`For Direct bank entry, required fields depend on the transfer types you request.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`ACH Credit`}),_jsx(_components.th,{children:`Same Day ACH Credit`}),_jsx(_components.th,{children:`FedNow Credit`}),_jsx(_components.th,{children:`Wire`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`owner`})}),_jsx(_components.td,{children:`Required`}),_jsx(_components.td,{children:`Required`}),_jsx(_components.td,{children:`Required`}),_jsx(_components.td,{children:`Required`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`account_number`})}),_jsx(_components.td,{children:`Required`}),_jsx(_components.td,{children:`Required`}),_jsx(_components.td,{children:`Required`}),_jsx(_components.td,{children:`Required`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`routing_number`})}),_jsx(_components.td,{children:`Required`}),_jsx(_components.td,{children:`Required`}),_jsx(_components.td,{children:`Required`}),_jsx(_components.td,{children:`Required`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`account_type`})}),_jsx(_components.td,{children:`Required`}),_jsx(_components.td,{children:`Required`}),_jsx(_components.td,{children:`Required`}),_jsx(_components.td,{children:`Required`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`transfer_types`})}),_jsx(_components.td,{children:`Required`}),_jsx(_components.td,{children:`Required`}),_jsx(_components.td,{children:`Required`}),_jsx(_components.td,{children:`Required`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`bank_address`})}),_jsx(_components.td,{children:`Optional`}),_jsx(_components.td,{children:`Optional`}),_jsx(_components.td,{children:`Optional`}),_jsx(_components.td,{children:`Required`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`beneficiary_address`})}),_jsx(_components.td,{children:`Optional`}),_jsx(_components.td,{children:`Optional`}),_jsx(_components.td,{children:`Optional`}),_jsx(_components.td,{children:`Required`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`If `,_jsx(_components.code,{children:`transfer_types`}),` includes `,_jsx(_components.code,{children:`wire`}),`, wire requirements apply. For addresses without `,_jsx(_components.code,{children:`wire`}),`, omit `,_jsx(_components.code,{children:`bank_address`}),` and `,_jsx(_components.code,{children:`beneficiary_address`}),` unless you have accurate values. Send `,_jsx(_components.code,{children:`account_number`}),` and `,_jsx(_components.code,{children:`routing_number`}),` as strings so leading zeros are preserved.`]}),`\n`,_jsx(Heading,{level:`3`,id:`direct-bank-entry-examples`,children:`Direct bank entry examples`}),`\n`,_jsxs(Heading,{level:`4`,id:`ach-credit-ach_credit-same_day_ach_credit`,children:[`ACH Credit (`,_jsx(_components.code,{children:`ach_credit`}),`, `,_jsx(_components.code,{children:`same_day_ach_credit`}),`)`]}),`\n`,_jsxs(_components.p,{children:[`Omit `,_jsx(_components.code,{children:`bank_address`}),` and `,_jsx(_components.code,{children:`beneficiary_address`}),` for ACH-only addresses.`]}),`\n`,_jsx(CodeBlock,{filename:`Request`,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"owner\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Jane Doe\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"transfer_types\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ach_credit\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"same_day_ach_credit\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"account_number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1234567890\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"routing_number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"063108680\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"account_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"checking\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Example Bank\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(Heading,{level:`4`,id:`fednow-credit-fednow_credit`,children:[`FedNow Credit (`,_jsx(_components.code,{children:`fednow_credit`}),`)`]}),`\n`,_jsxs(_components.p,{children:[`Omit `,_jsx(_components.code,{children:`bank_address`}),` and `,_jsx(_components.code,{children:`beneficiary_address`}),` for FedNow-only addresses.`]}),`\n`,_jsx(CodeBlock,{filename:`Request`,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"owner\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Jane Doe\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"transfer_types\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"fednow_credit\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"account_number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0012345678\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"routing_number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"063108680\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"account_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"checking\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Example Bank\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Do not assume `,_jsx(_components.code,{children:`fednow_credit`}),` is added asynchronously. `,_jsx(_components.a,{href:`/api-reference/brale/get-address`,children:`Retrieve the address`}),` and confirm `,_jsx(_components.code,{children:`status`}),` is `,_jsx(_components.code,{children:`active`}),` and `,_jsx(_components.code,{children:`transfer_types`}),` includes `,_jsx(_components.code,{children:`fednow_credit`}),` before you send a payout. See `,_jsx(_components.a,{href:`/guides/fednow-outbound`,children:`Send FedNow payouts`}),`.`]}),`\n`,_jsx(Heading,{level:`4`,id:`fednow-errors`,children:`FedNow errors`}),`\n`,_jsx(_components.p,{children:`Brale returns these errors with the standard error envelope:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:_jsx(_components.code,{children:`type`})}),_jsx(_components.th,{children:`Meaning`}),_jsx(_components.th,{children:`Retry`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`422`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`fednow_routing_number_not_supported`})}),_jsx(_components.td,{children:`The routing number does not participate in FedNow.`}),_jsx(_components.td,{children:`No. Use another rail.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`422`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`fednow_provider_registration_failed`})}),_jsx(_components.td,{children:`FedNow registration failed. This can be temporary.`}),_jsxs(_components.td,{children:[`Yes. Retry with the same `,_jsx(_components.code,{children:`Idempotency-Key`}),` and body after a backoff.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_transfer_types`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`transfer_types`}),` includes a value the address cannot use, most often `,_jsx(_components.code,{children:`rtp_credit`}),`. The `,_jsx(_components.code,{children:`detail`}),` reads `,_jsx(_components.code,{children:`Invalid transfer types; Address transfer types must be compatible chains`}),`.`]}),_jsxs(_components.td,{children:[`No. Replace `,_jsx(_components.code,{children:`rtp_credit`}),` with `,_jsx(_components.code,{children:`fednow_credit`}),`. See `,_jsxs(_components.a,{href:`/guides/fednow-outbound#migrate-from-rtp_credit-to-fednow_credit`,children:[`Migrate from `,_jsx(_components.code,{children:`rtp_credit`})]}),`.`]})]})]})]}),`\n`,_jsx(CodeBlock,{filename:`Response (422)`,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"fednow_routing_number_not_supported\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"detail\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"The routing number does not support FedNow.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`422`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`4`,id:`disabled-bank-accounts`,children:`Disabled bank accounts`}),`\n`,_jsxs(_components.p,{children:[`If the bank account matches an external address that Brale disabled after a return, Brale returns `,_jsx(_components.code,{children:`422`}),` `,_jsx(_components.code,{children:`external_address_disabled`}),` and does not create a new address. Contact support to re-enable the existing address. See `,_jsx(_components.a,{href:`/documentation/troubleshooting#422-external_address_disabled`,children:`Troubleshooting`}),`.`]}),`\n`,_jsxs(Heading,{level:`4`,id:`wire-wire`,children:[`Wire (`,_jsx(_components.code,{children:`wire`}),`)`]}),`\n`,_jsxs(_components.p,{children:[`Wire-capable addresses require both `,_jsx(_components.code,{children:`bank_address`}),` and `,_jsx(_components.code,{children:`beneficiary_address`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:`Request`,numberOfLines:`22`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`22`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"owner\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Jane Doe\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"transfer_types\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"wire\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"account_number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1234567890\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"routing_number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"063108680\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"account_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"checking\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Example Bank\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"bank_address\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"street_line_1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"100 Example St\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"street_line_2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Suite 500\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"city\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Springfield\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"state\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CA\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"zip\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"90001\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"beneficiary_address\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"street_line_1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"100 Example St\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"street_line_2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Suite 500\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"city\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Springfield\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"state\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CA\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"zip\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"90001\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`If you include `,_jsx(_components.code,{children:`wire`}),` in `,_jsx(_components.code,{children:`transfer_types`}),`, both `,_jsx(_components.code,{children:`bank_address`}),` and `,_jsx(_components.code,{children:`beneficiary_address`}),` are required, even if the same address also includes ACH or FedNow rails.`]})}),`\n`,_jsx(_components.p,{children:`Use the playground below to try this endpoint directly, or review the OpenAPI details in the right panel.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a new external address","description":"Create an external bank address with account and routing numbers for wire, ACH credit, and FedNow payouts using the Direct bank entry path.","openapi":"POST /accounts/{account_id}/addresses/external","href":"/api-reference/brale/create-address"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Direct bank entry field requirements","slug":"direct-bank-entry-field-requirements","depth":3,"children":[]},{"title":"Direct bank entry examples","slug":"direct-bank-entry-examples","depth":3,"children":[]},{"title":"ACH Credit (ach_credit, same_day_ach_credit)","slug":"ach-credit-ach_credit-same_day_ach_credit","depth":4,"children":[]},{"title":"FedNow Credit (fednow_credit)","slug":"fednow-credit-fednow_credit","depth":4,"children":[]},{"title":"FedNow errors","slug":"fednow-errors","depth":4,"children":[]},{"title":"Disabled bank accounts","slug":"disabled-bank-accounts","depth":4,"children":[]},{"title":"Wire (wire)","slug":"wire-wire","depth":4,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Addresses"],"operationId":"createAddress","summary":"Create a new external address","description":"Create an external bank address with account and routing numbers for wire, ACH credit, and FedNow payouts using the Direct bank entry path.","parameters":["a2a75176-aa18-4abf-b2ef-11d2118540b6","995bdd1a-8db1-4e1c-b22a-a7b20aace151"],"requestBody":"216db6be-db61-4bc1-90ad-ee85a0c735cf","responses":{"201":"31043c2f-c07e-4b21-a6f6-1ffb463666d7","400":"71378492-d063-49e2-9ee7-bf9bbc593f0f","422":"d0aad40d-f0fa-424d-a735-4dfc53f572f5"},"method":"post","type":"path","servers":["8da73adf-e60e-4374-8982-c73a1cf2599d"],"security":["4b324c94-2450-4d2d-a109-b207e1fdd9e4"],"path":"/accounts/{account_id}/addresses/external","baseUrlOptions":["https://api.brale.xyz"],"title":"Create a new external address","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"a2a75176-aa18-4abf-b2ef-11d2118540b6":{"name":"account_id","in":"path","required":true,"description":"The ID of the account","schema":{"title":"Kusid","type":"string","format":"ksuid","pattern":"^[a-zA-Z0-9]{27}$","example":"2VcUIIsgARwVbEGlIYbhg6fGG57","isRequired":true,"description":"The ID of the account","uniqueKey":"","typeLabel":"string\u003cksuid>"}},"995bdd1a-8db1-4e1c-b22a-a7b20aace151":{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","isRequired":true,"description":"A unique string used to prevent duplicate operations. Each POST request must use a new idempotency key. Use a UUIDv4 string. Example: `idemp-123e4567-e89b-12d3-a456-426614174000`\n","uniqueKey":"","typeLabel":"string"},"example":"idemp-123e4567-e89b-12d3-a456-426614174000","description":"A unique string used to prevent duplicate operations. Each POST request must use a new idempotency key. Use a UUIDv4 string. Example: `idemp-123e4567-e89b-12d3-a456-426614174000`\n"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","title":"CreateExternalBlockchainAddressRequest","required":["name","address","transfer_types"],"properties":{"name":{"oneOf":[{"type":"string","example":"Company External EVM Address","isRequired":true,"uniqueKey":"oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","example":"Company External EVM Address","isRequired":true,"uniqueKey":"oneOf.0.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.name","typeLabel":"string | null"},"address":{"type":"string","example":"0xb518d4d6221d9a41d23d71cbce8e106e7aab8f9b","isRequired":true,"uniqueKey":"oneOf.0.address","typeLabel":"string"},"transfer_types":{"type":"array","items":{"type":"string","example":"solana","uniqueKey":"oneOf.0.transfer_types.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"oneOf.0.transfer_types","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"CreateExternalBlockchainAddressRequest · object"},{"type":"object","title":"CreateExternalFinancialInstitutionRequest","description":"Address fields are conditional. `bank_address` and `beneficiary_address` are required when `transfer_types` includes `wire`. They are optional for `ach_credit`, `same_day_ach_credit`, `rtp_credit`, and `fednow_credit`. For addresses without `wire`, do not provide placeholder or generic bank addresses. Omit these fields unless you have accurate values. Requesting `fednow_credit` requires a routing number that participates in FedNow; otherwise Brale returns `422` `fednow_routing_number_not_supported`.\n","required":["owner","account_number","routing_number","account_type","transfer_types"],"properties":{"owner":{"type":"string","example":"Jane Doe","isRequired":true,"uniqueKey":"oneOf.1.owner","typeLabel":"string"},"account_number":{"type":"string","example":"123456789","isRequired":true,"uniqueKey":"oneOf.1.account_number","typeLabel":"string"},"routing_number":{"type":"string","example":"123456789","isRequired":true,"uniqueKey":"oneOf.1.routing_number","typeLabel":"string"},"account_type":{"type":"string","enum":["checking","savings"],"example":"checking","isRequired":true,"uniqueKey":"oneOf.1.account_type","typeLabel":"enum\u003cstring>"},"transfer_types":{"type":"array","minItems":1,"description":"Rails to enable for this bank endpoint. If this array includes `wire`, the request must include `bank_address` and `beneficiary_address`. For addresses without `wire` (for example, ACH, RTP, or FedNow only), those address fields are optional.\n","items":{"type":"string","example":"ach_credit","uniqueKey":"oneOf.1.transfer_types.items.[INDEX]","typeLabel":"string"},"example":["ach_credit","rtp_credit","fednow_credit"],"isRequired":true,"uniqueKey":"oneOf.1.transfer_types","typeLabel":"string[]"},"name":{"type":"string","example":"First Last Bank","uniqueKey":"oneOf.1.name","typeLabel":"string"},"account_holder_type":{"type":"string","enum":["individual","business"],"description":"Whether the bank account is held by an individual or a business. Optional. Determines the ACH SEC code for payouts to this address (`individual` → PPD, `business` → CCD). If omitted, Brale uses the entity type of the account that owns the address. Once set, it cannot be changed.\n","example":"business","uniqueKey":"oneOf.1.account_holder_type","typeLabel":"enum\u003cstring>"},"date_of_birth":{"type":"string","format":"date","description":"Optional. Date of birth of an individual recipient, in `YYYY-MM-DD` format. Accepted when `account_holder_type` is `individual` or not set. Sending it with `account_holder_type: business` returns `400` `date_of_birth_not_supported`. A malformed or future date returns `400` `validation_errors`. Responses return the date masked to the year (`1990-**-**`).\n","example":"1990-01-31","uniqueKey":"oneOf.1.date_of_birth","typeLabel":"string\u003cdate>"},"bank_address":{"type":"object","title":"USStreetAddress","description":"Bank physical address. Required when `transfer_types` includes `wire`. Optional for `ach_credit`, `same_day_ach_credit`, `rtp_credit`, and `fednow_credit`.\n","required":["street_line_1","city","state","zip"],"properties":{"street_line_1":{"type":"string","example":"100 Example St.","isRequired":true,"uniqueKey":"oneOf.1.bank_address.street_line_1","typeLabel":"string"},"city":{"type":"string","example":"Springfield","isRequired":true,"uniqueKey":"oneOf.1.bank_address.city","typeLabel":"string"},"state":{"type":"string","example":"CA","isRequired":true,"uniqueKey":"oneOf.1.bank_address.state","typeLabel":"string"},"zip":{"type":"string","example":"90001","isRequired":true,"uniqueKey":"oneOf.1.bank_address.zip","typeLabel":"string"},"street_line_2":{"type":"string","example":"Suite 500","uniqueKey":"oneOf.1.bank_address.street_line_2","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"oneOf.1.bank_address","typeLabel":"USStreetAddress · object"},"beneficiary_address":{"type":"object","title":"USStreetAddress","description":"Beneficiary physical address. Required when `transfer_types` includes `wire`. Optional for `ach_credit`, `same_day_ach_credit`, `rtp_credit`, and `fednow_credit`.\n","required":["street_line_1","city","state","zip"],"properties":{"street_line_1":{"type":"string","example":"100 Example St.","isRequired":true,"uniqueKey":"oneOf.1.beneficiary_address.street_line_1","typeLabel":"string"},"city":{"type":"string","example":"Springfield","isRequired":true,"uniqueKey":"oneOf.1.beneficiary_address.city","typeLabel":"string"},"state":{"type":"string","example":"CA","isRequired":true,"uniqueKey":"oneOf.1.beneficiary_address.state","typeLabel":"string"},"zip":{"type":"string","example":"90001","isRequired":true,"uniqueKey":"oneOf.1.beneficiary_address.zip","typeLabel":"string"},"street_line_2":{"type":"string","example":"Suite 500","uniqueKey":"oneOf.1.beneficiary_address.street_line_2","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"oneOf.1.beneficiary_address","typeLabel":"USStreetAddress · object"}},"additionalProperties":false,"uniqueKey":"oneOf.1","typeLabel":"CreateExternalFinancialInstitutionRequest · object"}],"uniqueKey":"","typeLabel":"CreateExternalBlockchainAddressRequest · object | CreateExternalFinancialInstitutionRequest · object"},"examples":{"onchain_base":{"title":"onchain_base","summary":"On-chain (Base)","value":{"name":"Base External Wallet","transfer_types":["base"],"address":"0xE57e438aE0b1557bFC1ad70BD7751635E473D888"}},"offchain_ach_credit":{"title":"offchain_ach_credit","summary":"Off-chain (ACH Credit / Same Day ACH Credit)","value":{"owner":"Jane Doe","transfer_types":["ach_credit","same_day_ach_credit"],"account_number":"1234567890","routing_number":"063108680","account_type":"checking","account_holder_type":"business","name":"Example Bank"}},"offchain_rtp_credit":{"title":"offchain_rtp_credit","summary":"Off-chain (ACH + RTP Credit)","value":{"owner":"Jane Doe","transfer_types":["ach_credit","same_day_ach_credit","rtp_credit"],"account_number":"1234567890","routing_number":"063108680","account_type":"checking","name":"Example Bank"}},"offchain_individual_with_date_of_birth":{"title":"offchain_individual_with_date_of_birth","summary":"Off-chain (ACH Credit, individual recipient with date of birth)","value":{"owner":"Jane Doe","transfer_types":["ach_credit"],"account_number":"1234567890","routing_number":"063108680","account_type":"checking","account_holder_type":"individual","date_of_birth":"1990-01-31","name":"Example Bank"}},"offchain_fednow_credit":{"title":"offchain_fednow_credit","summary":"Off-chain (FedNow Credit, no postal addresses required)","value":{"owner":"Jane Doe","transfer_types":["fednow_credit"],"account_number":"0012345678","routing_number":"063108680","account_type":"checking","name":"Example Bank"}},"offchain_wire":{"title":"offchain_wire","summary":"Off-chain (Wire — requires bank_address and beneficiary_address)","value":{"owner":"Jane Doe","transfer_types":["wire"],"account_number":"1234567890","routing_number":"063108680","account_type":"checking","name":"Example Bank","bank_address":{"street_line_1":"100 Example St","street_line_2":"Suite 500","city":"Springfield","state":"CA","zip":"90001"},"beneficiary_address":{"street_line_1":"100 Example St","street_line_2":"Suite 500","city":"Springfield","state":"CA","zip":"90001"}}},"offchain_ach_debit":{"title":"offchain_ach_debit","summary":"Off-chain (ACH Debit via Plaid)","value":{"name":"Operating Account (ACH Debit)","transfer_types":["ach_debit","same_day_ach_debit"],"plaid_token":"PUBLIC_TOKEN_EXCHANGED_WITH_BRALE"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"31043c2f-c07e-4b21-a6f6-1ffb463666d7":{"description":"External address successfully created","content":{"*/*":{"schema":{"title":"ExternalAddressResponse","type":"object","description":"The full external address object returned by `POST /accounts/{account_id}/addresses/external`.","properties":{"id":{"title":"Kusid","type":"string","format":"ksuid","pattern":"^[a-zA-Z0-9]{27}$","example":"2VcUIIsgARwVbEGlIYbhg6fGG57","uniqueKey":"id","typeLabel":"string\u003cksuid>"},"name":{"oneOf":[{"type":"string","example":"checking 7890","uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","example":"checking 7890","uniqueKey":"name.oneOf.1","typeLabel":"null"}],"uniqueKey":"name","typeLabel":"string | null"},"owner":{"type":"string","example":"Jane Doe","uniqueKey":"owner","typeLabel":"string"},"status":{"type":"string","example":"active","uniqueKey":"status","typeLabel":"string"},"ownership":{"type":"string","example":"customer-owned","uniqueKey":"ownership","typeLabel":"string"},"account_holder_type":{"oneOf":[{"type":"string","enum":["individual","business"],"description":"Whether the bank account is held by an individual or a business. `null` if it was not set.","example":"business","uniqueKey":"account_holder_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["individual","business"],"description":"Whether the bank account is held by an individual or a business. `null` if it was not set.","example":"business","uniqueKey":"account_holder_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"account_holder_type","typeLabel":"enum\u003cstring> | null"},"date_of_birth":{"oneOf":[{"type":"string","description":"Recipient's date of birth, masked to the year (`YYYY-**-**`). Brale never returns the full date. `null` if no date of birth is on file.","example":"1990-**-**","uniqueKey":"date_of_birth.oneOf.0","typeLabel":"string"},{"type":"null","description":"Recipient's date of birth, masked to the year (`YYYY-**-**`). Brale never returns the full date. `null` if no date of birth is on file.","example":"1990-**-**","uniqueKey":"date_of_birth.oneOf.1","typeLabel":"null"}],"uniqueKey":"date_of_birth","typeLabel":"string | null"},"bank_address":{"oneOf":[{"type":"object","title":"ExternalAddressResponseStreetAddress","description":"US street address as returned in external address responses. Includes `country`, unlike the request `USStreetAddress` schema.","properties":{"street_line_1":{"type":"string","example":"100 Example St","uniqueKey":"bank_address.oneOf.0.street_line_1","typeLabel":"string"},"street_line_2":{"oneOf":[{"type":"string","example":"Suite 500","uniqueKey":"bank_address.oneOf.0.street_line_2.oneOf.0","typeLabel":"string"},{"type":"null","example":"Suite 500","uniqueKey":"bank_address.oneOf.0.street_line_2.oneOf.1","typeLabel":"null"}],"uniqueKey":"bank_address.oneOf.0.street_line_2","typeLabel":"string | null"},"city":{"type":"string","example":"Springfield","uniqueKey":"bank_address.oneOf.0.city","typeLabel":"string"},"state":{"type":"string","example":"CA","uniqueKey":"bank_address.oneOf.0.state","typeLabel":"string"},"zip":{"type":"string","example":"90001","uniqueKey":"bank_address.oneOf.0.zip","typeLabel":"string"},"country":{"type":"string","example":"US","uniqueKey":"bank_address.oneOf.0.country","typeLabel":"string"}},"uniqueKey":"bank_address.oneOf.0","typeLabel":"ExternalAddressResponseStreetAddress · object"},{"type":"null","uniqueKey":"bank_address.oneOf.1","typeLabel":"null"}],"uniqueKey":"bank_address","typeLabel":"ExternalAddressResponseStreetAddress · object | null"},"beneficiary_address":{"oneOf":[{"type":"object","title":"ExternalAddressResponseStreetAddress","description":"US street address as returned in external address responses. Includes `country`, unlike the request `USStreetAddress` schema.","properties":{"street_line_1":{"type":"string","example":"100 Example St","uniqueKey":"beneficiary_address.oneOf.0.street_line_1","typeLabel":"string"},"street_line_2":{"oneOf":[{"type":"string","example":"Suite 500","uniqueKey":"beneficiary_address.oneOf.0.street_line_2.oneOf.0","typeLabel":"string"},{"type":"null","example":"Suite 500","uniqueKey":"beneficiary_address.oneOf.0.street_line_2.oneOf.1","typeLabel":"null"}],"uniqueKey":"beneficiary_address.oneOf.0.street_line_2","typeLabel":"string | null"},"city":{"type":"string","example":"Springfield","uniqueKey":"beneficiary_address.oneOf.0.city","typeLabel":"string"},"state":{"type":"string","example":"CA","uniqueKey":"beneficiary_address.oneOf.0.state","typeLabel":"string"},"zip":{"type":"string","example":"90001","uniqueKey":"beneficiary_address.oneOf.0.zip","typeLabel":"string"},"country":{"type":"string","example":"US","uniqueKey":"beneficiary_address.oneOf.0.country","typeLabel":"string"}},"uniqueKey":"beneficiary_address.oneOf.0","typeLabel":"ExternalAddressResponseStreetAddress · object"},{"type":"null","uniqueKey":"beneficiary_address.oneOf.1","typeLabel":"null"}],"uniqueKey":"beneficiary_address","typeLabel":"ExternalAddressResponseStreetAddress · object | null"},"created":{"type":"string","format":"date-time","example":"2026-06-02T20:01:02.226850Z","uniqueKey":"created","typeLabel":"string\u003cdate-time>"},"transfer_types":{"type":"array","items":{"type":"string","uniqueKey":"transfer_types.items.[INDEX]","typeLabel":"string"},"example":["ach_credit"],"uniqueKey":"transfer_types","typeLabel":"string[]"},"account_number":{"type":"string","description":"Returned masked (e.g. `****7890`).","example":"****7890","uniqueKey":"account_number","typeLabel":"string"},"account_type":{"type":"string","enum":["checking","savings"],"example":"checking","uniqueKey":"account_type","typeLabel":"enum\u003cstring>"},"needs_update":{"type":"boolean","example":false,"uniqueKey":"needs_update","typeLabel":"boolean"},"last_updated":{"type":"string","format":"date-time","example":"2026-06-02T20:01:03.321461Z","uniqueKey":"last_updated","typeLabel":"string\u003cdate-time>"},"routingNumber":{"type":"string","description":"Note: this single field is currently returned in camelCase (`routingNumber`) while all other fields use snake_case.","example":"063108680","uniqueKey":"routingNumber","typeLabel":"string"}},"uniqueKey":"","typeLabel":"ExternalAddressResponse · object"},"examples":{"offchain_ach_credit":{"title":"offchain_ach_credit","summary":"Off-chain bank address (ACH Credit)","value":{"id":"3EaxQ8mDX3RLdK9wvn1BAptMs6H","name":"checking 7890","owner":"Jane Doe","status":"active","ownership":"customer-owned","account_holder_type":"business","date_of_birth":null,"bank_address":null,"beneficiary_address":{"street_line_1":"100 Example St","street_line_2":"Suite 500","city":"Springfield","state":"CA","zip":"90001","country":"US"},"created":"2026-06-02T20:01:02.226850Z","transfer_types":["ach_credit"],"account_number":"****7890","account_type":"checking","needs_update":false,"last_updated":"2026-06-02T20:01:03.321461Z","routingNumber":"063108680"}}},"exampleType":"examples"}},"exampleType":"examples"},"71378492-d063-49e2-9ee7-bf9bbc593f0f":{"description":"Bad request. Date of birth cases:\n\n- `date_of_birth_not_supported`: `date_of_birth` was sent with\n `account_holder_type: business`. Brale does not create the address.\n\n- `validation_errors`: `date_of_birth` is malformed or in the future.\n The error response does not include the submitted value.\n","content":{"application/json":{"schema":{"title":"ApiErrorV2","type":"object","description":"Error envelope returned by newer Brale endpoints.","required":["type"],"properties":{"type":{"type":"string","description":"Machine-readable error type identifier.","example":"automation_not_active","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"detail":{"type":"string","description":"Human-readable explanation of the error.","example":"Automation must be active to simulate a deposit","uniqueKey":"detail","typeLabel":"string"},"code":{"type":"string","example":"ValidationError","uniqueKey":"code","typeLabel":"string"},"status":{"type":"integer","example":422,"uniqueKey":"status","typeLabel":"integer"},"values":{"type":"array","items":{"type":"string","uniqueKey":"values.items.[INDEX]","typeLabel":"string"},"uniqueKey":"values","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"ApiErrorV2 · object"},"examples":{"date_of_birth_not_supported":{"title":"date_of_birth_not_supported","summary":"Date of birth sent for a business recipient","value":{"type":"date_of_birth_not_supported","detail":"date_of_birth can only be set when account_holder_type is individual or not set.","code":"ValidationError","status":400}}},"exampleType":"examples"}},"exampleType":"examples"},"d0aad40d-f0fa-424d-a735-4dfc53f572f5":{"description":"The request is valid but cannot be processed. FedNow-related cases:\n\n- `fednow_routing_number_not_supported`: the `routing_number` does not\n participate in FedNow. Do not retry with the same body. Remove\n `fednow_credit` or use a FedNow-participating account.\n\n- `fednow_provider_registration_failed`: Brale could not register the\n recipient for FedNow with its banking provider. This can be temporary.\n Retry the same request with the same `Idempotency-Key` after a backoff.\n","content":{"application/json":{"schema":{"title":"ApiErrorV2","type":"object","description":"Error envelope returned by newer Brale endpoints.","required":["type"],"properties":{"type":{"type":"string","description":"Machine-readable error type identifier.","example":"automation_not_active","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"detail":{"type":"string","description":"Human-readable explanation of the error.","example":"Automation must be active to simulate a deposit","uniqueKey":"detail","typeLabel":"string"},"code":{"type":"string","example":"ValidationError","uniqueKey":"code","typeLabel":"string"},"status":{"type":"integer","example":422,"uniqueKey":"status","typeLabel":"integer"},"values":{"type":"array","items":{"type":"string","uniqueKey":"values.items.[INDEX]","typeLabel":"string"},"uniqueKey":"values","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"ApiErrorV2 · object"},"examples":{"fednow_routing_number_not_supported":{"title":"fednow_routing_number_not_supported","summary":"Routing number does not support FedNow","value":{"type":"fednow_routing_number_not_supported","detail":"The routing number does not support FedNow.","status":422}},"fednow_provider_registration_failed":{"title":"fednow_provider_registration_failed","summary":"FedNow recipient registration failed","value":{"type":"fednow_provider_registration_failed","detail":"The recipient could not be registered for FedNow. Try again later.","status":422}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"4b324c94-2450-4d2d-a109-b207e1fdd9e4":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Use the Bearer token returned from the Auth endpoint via OAuth2 client_credentials flow. Include the token in the \"Authorization: Bearer \u003ctoken>\" header.\n","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"8da73adf-e60e-4374-8982-c73a1cf2599d":{"url":"https://api.brale.xyz","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Use the Bearer token returned from the Auth endpoint via OAuth2 client_credentials flow. Include the token in the \"Authorization: Bearer \u003ctoken>\" header.\n","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Use the Bearer token returned from the Auth endpoint via OAuth2 client_credentials flow. Include the token in the \"Authorization: Bearer \u003ctoken>\" header.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"api-reference/brale-openapi.yaml"},"subdomain":"brale","siteName":"Brale","title":"Create a new external address - Brale","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T01:16:48.624Z","originalFileLocation":"api-reference/brale/create-address.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create an external bank address with account and routing numbers for wire, ACH credit, and FedNow payouts using the Direct bank entry path.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Brale\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/brale/fNz744YuLs689rFY/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/brale/fNz744YuLs689rFY/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/brale/fNz744YuLs689rFY/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/brale/fNz744YuLs689rFY/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/brale/fNz744YuLs689rFY/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/brale/fNz744YuLs689rFY/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/brale/fNz744YuLs689rFY/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/brale/fNz744YuLs689rFY/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/brale/fNz744YuLs689rFY/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a new external address - Brale\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create an external bank address with account and routing numbers for wire, ACH credit, and FedNow payouts using the Direct bank entry path.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Brale\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.brale.xyz/api-reference/brale/create-address\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://brale.mintlify.site/_mintlify/api/og/v2?division=Addresses\u0026amp;title=Create+a+new+external+address\u0026amp;description=Create+an+external+bank+address+with+account+and+routing+numbers+for+wire%2C+ACH+credit%2C+and+FedNow+payouts+using+the+Direct+bank+entry+path.\u0026amp;theme=b2b665b22cc0ea8a2264b9db\u0026amp;signature=8a9361383312061dd8bb55db7f9eed7778ed712890ba0a377163064c52ba26cb\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a new external address - Brale\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create an external bank address with account and routing numbers for wire, ACH credit, and FedNow payouts using the Direct bank entry path.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://brale.mintlify.site/_mintlify/api/og/v2?division=Addresses\u0026amp;title=Create+a+new+external+address\u0026amp;description=Create+an+external+bank+address+with+account+and+routing+numbers+for+wire%2C+ACH+credit%2C+and+FedNow+payouts+using+the+Direct+bank+entry+path.\u0026amp;theme=b2b665b22cc0ea8a2264b9db\u0026amp;signature=8a9361383312061dd8bb55db7f9eed7778ed712890ba0a377163064c52ba26cb\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/brale/fNz744YuLs689rFY/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Brale\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.brale.xyz/api-reference/brale/create-address\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/brale/create-address.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.brale.xyz/#organization\",\"name\":\"Brale\",\"url\":\"https://docs.brale.xyz\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/brale/8ZhoPWIKA3trPz7_/images/brale/brale-logo-light.svg?fit=max\u0026auto=format\u0026n=8ZhoPWIKA3trPz7_\u0026q=85\u0026s=9d75182cc1a672349f431ab9462b2b14\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.brale.xyz#website\",\"name\":\"Brale\",\"url\":\"https://docs.brale.xyz\",\"publisher\":{\"@id\":\"https://docs.brale.xyz/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.brale.xyz/api-reference/brale/create-address#webpage\",\"url\":\"https://docs.brale.xyz/api-reference/brale/create-address\",\"name\":\"Create a new external address\",\"description\":\"Create an external bank address with account and routing numbers for wire, ACH credit, and FedNow payouts using the Direct bank entry path.\",\"dateModified\":\"2026-11-16T01:16:48.624Z\",\"isPartOf\":{\"@id\":\"https://docs.brale.xyz#website\"},\"breadcrumb\":{\"@id\":\"https://docs.brale.xyz/api-reference/brale/create-address#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.brale.xyz/api-reference/brale/create-address#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Addresses\",\"item\":\"https://docs.brale.xyz/api-reference/brale/list-addresses\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a new external address\",\"item\":\"https://docs.brale.xyz/api-reference/brale/create-address\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.brale.xyz/api-reference/brale/create-address#apireference\",\"headline\":\"Create a new external address\",\"name\":\"Create a new external address\",\"description\":\"Create an external bank address with account and routing numbers for wire, ACH credit, and FedNow payouts using the Direct bank entry path.\",\"url\":\"https://docs.brale.xyz/api-reference/brale/create-address\",\"mainEntityOfPage\":{\"@id\":\"https://docs.brale.xyz/api-reference/brale/create-address#webpage\"},\"dateModified\":\"2026-11-16T01:16:48.624Z\",\"publisher\":{\"@id\":\"https://docs.brale.xyz/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.brale.xyz#website\"}}]}\u003c/script>","agentPointerHref":"/api-reference/brale/create-address.md","siteName":"Brale","nav":{"global":{"anchors":[{"anchor":"API Keys","icon":"key","href":"https://app.brale.xyz"},{"anchor":"API Logs","icon":"database","href":"https://app.brale.xyz/api?tab=activity"},{"anchor":"Changelog","icon":"clock-rotate-left","href":"/changelog"}]},"tabs":[{"tab":"Information","pages":[{"title":"Information","href":"/documentation/introduction"}]},{"tab":"Tools","pages":[{"title":"Tools","href":"/documentation/commons-stablecoin-format"}]},{"tab":"API Docs","pages":[{"title":"API Docs","href":"/overview/introduction"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/how-to/get-your-account-id"}]},{"tab":"API reference","groups":[{"group":"API overview","pages":[{"title":"Brale Issuance and Orchestration API","href":"/api-reference/brale-introduction"}]},{"group":"Accounts","pages":[{"title":"Retrieve all accounts","openapi":"GET /accounts","href":"/api-reference/brale/list-accounts"},{"title":"Create a customer account","openapi":"POST /accounts","href":"/api-reference/brale/create-account"},{"title":"Retrieve a customer account","openapi":"GET /accounts/{account_id}","href":"/api-reference/brale/get-account"},{"title":"Stage a Verification Document","openapi":"POST /documents","href":"/api-reference/brale/stage-verification-document"},{"title":"List Verification Documents","openapi":"GET /accounts/{account_id}/verification/documents","href":"/api-reference/brale/list-verification-documents"},{"title":"Link Verification Documents","openapi":"PATCH /accounts/{account_id}","href":"/api-reference/brale/link-verification-documents"}]},{"group":"Addresses","pages":[{"title":"Fetch all addresses","openapi":"GET /accounts/{account_id}/addresses","href":"/api-reference/brale/list-addresses"},{"title":"Retrieve an address","description":"Retrieves a single internal or external Address by `address_id`.","openapi":"GET /accounts/{account_id}/addresses/{address_id}","href":"/api-reference/brale/get-address"},{"title":"Create a new external address","openapi":"POST /accounts/{account_id}/addresses/external","href":"/api-reference/brale/create-address"},{"title":"Create a new internal address","description":"Provision an additional custodial (internal) address for the specified account.","openapi":"POST /accounts/{account_id}/addresses/internal","href":"/api-reference/brale/create-internal-address"},{"title":"Update an Address","openapi":"PATCH /accounts/{account_id}/addresses/{address_id}","href":"/api-reference/brale/update-address"},{"title":"Get an address balance","openapi":"GET /accounts/{account_id}/addresses/{address_id}/balance","href":"/api-reference/brale/get-address-balance"}]},{"group":"Automations (virtual accounts)","pages":[{"title":"Fetch all automations for an account","openapi":"GET /accounts/{account_id}/automations","href":"/api-reference/brale/list-automations"},{"title":"Create an Automation","openapi":"POST /accounts/{account_id}/automations","href":"/api-reference/brale/create-automations"},{"title":"Retrieve a single automation","openapi":"GET /accounts/{account_id}/automations/{id}","href":"/api-reference/brale/get-automations"},{"title":"Archive an Automation","openapi":"PATCH /accounts/{account_id}/automations/{automation_id}","href":"/api-reference/brale/archive-automation"},{"title":"Simulate an Automation deposit","openapi":"api-reference/brale-openapi.yaml POST /accounts/{account_id}/automations/{automation_id}/simulations/deposits","href":"/api-reference/brale/simulate-automation-deposit"}]},{"group":"Transfers","pages":[{"title":"List transfers","sidebarTitle":"List transfers","openapi":"GET /accounts/{account_id}/transfers","href":"/api-reference/brale/list-transfers"},{"title":"Create a new transfer","openapi":"POST /accounts/{account_id}/transfers","href":"/api-reference/brale/create-transfer"},{"title":"Retrieve a single transfer","openapi":"GET /accounts/{account_id}/transfers/{id}","href":"/api-reference/brale/get-transfer"}]},{"group":"Financial institutions","pages":[{"title":"Fetch all financial institutions","openapi":"GET /accounts/{account_id}/financial-institutions","href":"/api-reference/brale/list-financial-institutions"},{"title":"Create a new external financial institution","openapi":"POST /accounts/{account_id}/financial-institutions/external","href":"/api-reference/brale/create-financial-institution"},{"title":"Fetch a specific financial institution","openapi":"GET /accounts/{account_id}/financial-institutions/{id}","href":"/api-reference/brale/get-financial-institution"},{"title":"Create Plaid link token","openapi":"POST /accounts/{account_id}/plaid/link_token","href":"/api-reference/brale/create-plaid-link-token"},{"title":"Register financial institution account via Plaid and return address ID","openapi":"POST /accounts/{account_id}/plaid/register-account","href":"/api-reference/brale/register-financial-institution-account-via-plaid-and-return-address-id"}]},{"group":"Webhooks","pages":[{"title":"List Webhook Event Types","openapi":"GET /accounts/{account_id}/webhooks/event_types","href":"/api-reference/brale/list-webhook-event-types"},{"title":"Create Webhook Subscription","openapi":"POST /accounts/{account_id}/webhooks","href":"/api-reference/brale/create-webhook-subscription"},{"title":"List Webhook Subscriptions","openapi":"GET /accounts/{account_id}/webhooks","href":"/api-reference/brale/list-webhook-subscriptions"},{"title":"Get Webhook Subscription","openapi":"GET /accounts/{account_id}/webhooks/{subscription_id}","href":"/api-reference/brale/get-webhook-subscription"},{"title":"Update Webhook Subscription","openapi":"PATCH /accounts/{account_id}/webhooks/subscriptions/{subscription_id}","href":"/api-reference/brale/update-webhook-subscription"},{"title":"Archive Webhook Subscription","openapi":"DELETE /accounts/{account_id}/webhooks/subscriptions/{subscription_id}","href":"/api-reference/brale/archive-webhook-subscription"},{"title":"List Webhook Delivery Attempts","openapi":"GET /accounts/{account_id}/webhooks/deliveries","href":"/api-reference/brale/list-webhook-delivery-attempts"}]},{"group":"Tokenization","pages":[{"title":"Create Token Mint","openapi":"POST /accounts/{account_id}/tokens/mints","href":"/api-reference/brale/create-token-mint"},{"title":"List Token Mints","openapi":"GET /accounts/{account_id}/tokens/mints","href":"/api-reference/brale/list-token-mints"},{"title":"Get Token Mint","openapi":"GET /accounts/{account_id}/tokens/mints/{mint_id}","href":"/api-reference/brale/get-token-mint"},{"title":"Create Token Burn","openapi":"POST /accounts/{account_id}/tokens/burns","href":"/api-reference/brale/create-token-burn"},{"title":"List Token Burns","openapi":"GET /accounts/{account_id}/tokens/burns","href":"/api-reference/brale/list-token-burns"},{"title":"Get Token Burn","openapi":"GET /accounts/{account_id}/tokens/burns/{burn_id}","href":"/api-reference/brale/get-token-burn"},{"title":"Create Token Transfer","openapi":"POST /accounts/{account_id}/tokens/transfers","href":"/api-reference/brale/create-token-transfer"},{"title":"List Token Transfers","openapi":"GET /accounts/{account_id}/tokens/transfers","href":"/api-reference/brale/list-token-transfers"},{"title":"Get Token Transfer","openapi":"GET /accounts/{account_id}/tokens/transfers/{transfer_id}","href":"/api-reference/brale/get-token-transfer"}]}]},{"tab":"Brale Status","href":"https://status.brale.xyz"}]},"basePath":"","title":"Create a new external address - Brale","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-jJHA3WSo.js","utils-DbZn3Mjn.js","cloneDeep-CnBnaSyy.js","_Uint8Array-CMQtTgBR.js","isObject-FP1Yky1u.js","utils-Bl2DvzOJ.js","addUniqueKeysToSchema-BwOLo9p1.js","snippetPresets-BBiPpKa-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-C0px4Tml.js","isEqual-zAyttAAO.js","usePlaygroundInputsStore-Dell6dGw.js","shallow-0VKqkSqN.js","getApiPlaygroundDisplay-CP_ctPEB.js","CodeSnippet-5L35ic0s.js","CodeSnippets-DOXbNhJw.js","Page-DRLI_2Ue.js","getPastedJson-VhzT9m2P.js","icon-CD8_AtCO.js","MethodPill-DGgOMftG.js","DuplicateIcon-DZ6A_EtN.js","createIcon-DUl4oM5f.js","DynamicMarkdown-BGHukeRM.js","SectionHeading-ChrEUs8u.js","axios-vUo_bRtp.js","Markdown-Dj-na-_-.js","dist-C5gjFYHe.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-DEBW87tT.js"]}