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.

Create a payout subaccount

This document shows you how to create a payout/transfer subaccount on Flutterwave.

Last updated 13 September 2026

post

https://api.flutterwave.com/v3/payout-subaccounts

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_name string required
The name of the wallet. It should be the name of the customer.

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

country string required
This is the customer's country.

mobilenumber string
This is the mobile number 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

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