---
title: "Create a sub account"
method: POST
path: "/v1/accounts"
tags: ["Accounts"]
---

# Create a sub account

`POST /v1/accounts`

## Request

- Base URL: `https://api.nomba.com`
- URL: `https://api.nomba.com/v1/accounts`
- Auth: HTTP bearer

You can use this endpoint to create a sub account that is part of your business.

## Headers

- `accountId` string, uuid, required

## Request body

- CreateAccountRequest
  - `accountRef` string, required: Account reference
  - `phoneNumber` string, required: Phone number
  - `email` string, email, required: Email address
  - `bvn` string, required: Bank Verification Number (BVN)
  - `pin` string, required: Personal Identification Number (PIN)
  - `accountName` string, required: Account holder's name
  - `currency` 'NGN', required: Currency code
  - `callbackUrl` string, url: Callback url
  - `expiryDate` string, date-time: Expiry date

## Response `200`

Account creation successful.

- object
  - `code` string, required: Response Code
  - `description` string, required: Response description
  - `data` CreateAccountResponse, required
    - `createdAt` string, date-time, required: Creation timestamp
    - `accountId` string, required: Account ID
    - `accountHolderId` string, required: Account holder ID
    - `accountRef` string, required: Account reference
    - `phoneNumber` string, required: Phone number
    - `email` string, email, required: Email address
    - `bvn` string, required: Bank Verification Number (BVN)
    - `status` 'ACTIVE' | 'INACTIVE' | 'SUSPENDED' | 'PND' | 'BLACKLISTED', required: Account status
    - `type` 'virtual' | 'outlet', required: Account type
    - `accountName` string, required: Account holder's name
    - `currency` 'NGN', required: Currency code
    - `callbackUrl` string, url: Callback url
    - `expiryDate` string, date-time: Expiry date

## Other responses

- `400`: The request body sent by merchant did not pass the validation checks
- `401`: The access_token provided to access the resource is missing or invalid.
- `403`: The client does not have the permissions to access this resource
- `404`: The record that the client is trying to access does not exist.
- `429`: The client has maxed out the number of calls within a time period on this resource.
- `500`: Downstream system error.

## Changes

- **2026-11-03** `278a25dccfe5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nomba/apis/vendor-api/changes/v1/accounts/post.md)

---

[API](https://skmtc.dev/nomba/apis/vendor-api.md) - [All operations](https://skmtc.dev/nomba/apis/vendor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nomba/apis/vendor-api/revisions/278a25dccfe5?raw)