Add Beneficiary Account

Add new beneficiary account

post

https://stage-capi.wewireafrica.comhttps://capi.wewireafrica.com

/v1/beneficiaries/{beneficiaryId}/accounts

Authorizations

bearerww-api-key

Path parameters

beneficiaryIdstringRequired

Body

application/json

accountNumberstringRequired

The account number of the beneficiary

accountNamestringRequired

The account name of the beneficiary account

currencystring · enumRequired

The currency of the beneficiary account

Possible values:

ibanstringOptional

The IBAN of the beneficiary account

sortCodestringRequired

The sort code of the beneficiary account

swiftBicstringOptional

The SWIFT BIC of the beneficiary account

routingNumberstringOptional

The routing number of the beneficiary account

countrystringOptional

The country of the beneficiary account

bankNamestringOptional

The bank name of the beneficiary account

settlementMethodstringRequired

The settlement method of the beneficiary account

accountCategorystringOptional

The account category of the beneficiary account

Responses

200

The created beneficiary account

application/json

idstringRequired

Unique account identifier

bankNamestringOptional

Bank name

accountNamestringRequired

Account holder name

accountNumberstringOptional

Account number

countrystringOptional

Country

swiftBicstringOptional

SWIFT/BIC code

routingNumberstringOptional

Routing number

ibanstringOptional

IBAN

sortCodestringOptional

Sort code

currencystring · enumRequired

Account currency

Possible values:

typestring · enumRequired

Account type

Possible values:

settlementMethodstring · enumOptional

Settlement method

Possible values:

accountCategorystring · enumOptional

Account category

Possible values:

externalIdstringOptional

External identifier

extraFieldsobjectOptional

Extra fields

createdAtstring · date-timeRequired

Account creation timestamp

updatedAtstring · date-timeRequired

Account last update timestamp

post

/v1/beneficiaries/{beneficiaryId}/accounts

HTTPcURLJavaScriptPython

POST /v1/beneficiaries/{beneficiaryId}/accounts HTTP/1.1
Host: stage-capi.wewireafrica.com
Content-Type: application/json
Accept: */*
Content-Length: 221

{
  "accountNumber": "text",
  "accountName": "text",
  "currency": "GHS",
  "iban": "text",
  "sortCode": "text",
  "swiftBic": "text",
  "routingNumber": "text",
  "country": "text",
  "bankName": "text",
  "settlementMethod": "text",
  "accountCategory": "text"
}

200

The created beneficiary account

{
  "id": "text",
  "bankName": "text",
  "accountName": "text",
  "accountNumber": "text",
  "country": "text",
  "swiftBic": "text",
  "routingNumber": "text",
  "iban": "text",
  "sortCode": "text",
  "currency": "NGN",
  "type": "MOBILE_MONEY",
  "settlementMethod": "ACH",
  "accountCategory": "CHECKING",
  "externalId": "text",
  "extraFields": {},
  "createdAt": "2026-03-12T00:04:24.020Z",
  "updatedAt": "2026-03-12T00:04:24.020Z"
}