AI agents: this site is available as Markdown at /llms.txt. Each page has a Markdown version at its URL with a .md suffix, and the full API is described in /api/v3/openapi.json.

Update a payout subaccount

Update the wallet details on a payout subaccount.

Last updated 13 September 2026

put

https://api.flutterwave.com/v3/payout-subaccounts/{account_reference}

authorization string required

Pass your secret key as a bearer token in the request header to authorize this call

FILL IN ALL REQUIRED FIELDS

account_reference string required
Unique identifier of the payout subaccount

FILL IN ALL REQUIRED FIELDS

account_name string required
This is the name of the payout subaccount.

email string required
This is the email address of the payout subaccount

mobilenumber string required
This is the mobile number of the payout subaccount

country string
This is the country of the payout subaccount

FILL IN ALL REQUIRED FIELDS

status string

message string

data object

FILL IN ALL REQUIRED FIELDS

id integer

account_reference string

account_name string

barter_id string

email string

mobilenumber string

country string

nuban string

bank_name string

bank_code string

status string

created_at string

FILL IN ALL REQUIRED FIELDS

status string

message string

data string

Shell

1
1


FL.AI

Answers from the Flutterwave docs

Hi, I’m FL.AI

Ask anything about Flutterwave’s APIs, guides and coverage.

FL.AI can make mistakes. Check important details in the docs.

Get API Keys