Rename Account

POST

/account/rename

This API allows users to update the name of an account.

Request Body

The request is a JSON object containing the following fields:

Field Name	Data Type	Required	Description
name	string	true	The new name for the account.
accountID	string	true	The unique identifier of the account to rename.

Response Body

The response is a JSON object containing the updated account details.

Field Name	Data Type	Description
name	string	The updated name of the account.
createdDate	string	The timestamp when the account record was created.
updatedDate	string	The timestamp when the account record was last updated.
bvn	string	The Bank Verification Number (BVN) associated with the account.
accountID	string	The unique identifier of the account.

Request

Body Params application/json

Example

{
    "name":"Landmark POS Agent",
    "accountID":"0000000606"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/account/rename' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name":"Landmark POS Agent",
    "accountID":"0000000606"
}'

Responses

🟢200Rename Account

application/json

Body

Example

{
    "name": "Landmark POS Agent",
    "createdDate": "2023-04-19T11:42:54.000+00:00",
    "updatedDate": "2023-04-19T11:42:54.000+00:00",
    "bvn": "12121211221",
    "accountID": "0000000606"
}

Modified at 2025-04-02 07:57:02

Create Account

Balance Inquiry