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

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-20T22:54:34.895Z",
  "updatedAt": "2026-03-20T22:54:34.895Z"
}