Link
Last updated August 13th, 2025
post api.withmono.com/owo/v1/beneficiaries/linkv1.0
This resource allows you to initiate the process of linking your service to a user's account. This action sends an authorization request to the user via WhatsApp. You can also include an initial fund_request to be created immediately upon successful linking.
Body params
Headers
Request
123456789101112131415161718192021222324252627
curl --request POST \
--url https://api.withmono.com/owo/v1/beneficiaries/link \
--header 'accept: application/json' \
--header 'mono-sec-key: string' \
--header 'Content-Type: application/json' \
--data '{
"phone": "2349136923755",
"bvn": "12X4X67X9X1",
"fund_beneficiary": {
"name": "MARY JANE",
"nip_code": "000013",
"account_number": "0123456789"
},
"fund_request": {
"reference": "ABCDEFabcdef123456",
"description": "Weekly savings top-up",
"amount": 1000000,
"currency": "NGN",
"type": "recurring",
"schedule": {
"period": "week",
"interval": 1,
"start_date": "2026-01-01",
"end_date": "2026-01-02"
}
}
}
Response
Choose an option from the drop down or click one of these buttons to see an example:
