POST
/
v1
/
accounts
curl --request POST \
  --url https://api.nomba.com/v1/accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'accountId: <accountid>' \
  --data '{
  "accountName": "Daniel Scorsese",
  "accountRef": "1oWbJQQHLyQqqf1SwxjSpudeA21",
  "bvn": "12234412345",
  "callbackUrl": "https://webhook.site/98ef100f-5adc-4434-800a-0808h60bd8d7",
  "currency": "NGN",
  "email": "[email protected]",
  "expiryDate": "2023-12-06T15:46:43.000Z",
  "phoneNumber": "2348188667581",
  "pin": "1234"
}'
{
  "code": "00",
  "data": {
    "accountHolderId": "01a10aeb-d989-460a-bbde-9842f2b4320f",
    "accountId": "fc81b80e-e607-4b86-8591-840925191733",
    "accountName": "Daniel Scorsese",
    "accountRef": "1oWbJQQHLyQqqf1SwxjSpudeA21",
    "bvn": "12234412345",
    "callbackUrl": "https://webhook.site/98ef100f-5adc-4434-800a-0808h60bd8d7",
    "createdAt": "2023-09-04T07:09:06.900Z",
    "currency": "NGN",
    "email": "[email protected]",
    "expiryDate": "2023-12-06T15:46:43.000Z",
    "phoneNumber": "2348188667581",
    "status": "ACTIVE",
    "type": "virtual"
  },
  "description": "Success"
}

Authorizations

Authorization
string
headerrequired

Nomba authenticates API calls with OAuth2 HTTP bearer tokens. There are two methods of authentication; Client-Credentials method and PKCE (Proof Key for Code Exchange) method. In each of the methods, You will get an ACCESS_TOKEN. You need to use an "Authorization" HTTP header to provide your ACCESS_TOKEN. For example: Authorization: {ACCESS_TOKEN}.

Headers

accountId
string
required

The parent accountId of the business.

Body

application/json
accountName
string
required

Account holder's name

accountRef
string
required

Account reference

bvn
string
required

Bank Verification Number (BVN)

callbackUrl
string

Callback url

currency
enum<string>
required

Currency code

Available options:
NGN
email
string
required

Email address

expiryDate
string

Expiry date

phoneNumber
string
required

Phone number

pin
string
required

Personal Identification Number (PIN)

Response

200 - application/json
code
string
required

Response Code

data
object
required
description
string
required

Response description