Create Customer

You can create a new customer in your account. Customers can be sent payment requests and invoices to make payments.

NOTE: the email address of each customer must be unique in your account.

Creates a new customer in the merchant's profile.

post

Authorizations

Bearer

AuthorizationstringRequired

API Key as Bearer Token

Body

application/jsontext/jsonapplication/*+json

full_namestring · nullableOptional

Customer's full name (OPTIONAL)

emailstring · nullableOptional

Customer's email (REQUIRED)

phone_numberstring · nullableOptional

Customer's phone number (OPTIONAL)

addressstring · nullableOptional

Customer's address (OPTIONAL)

Responses

200

Returns 200 and the customer to retry

application/json

idstring · nullableOptional

full_namestring · nullableOptional

Customer's full name (OPTIONAL)

emailstring · nullableOptional

Customer's email (REQUIRED)

phone_numberstring · nullableOptional

Customer's phone number (OPTIONAL)

addressstring · nullableOptional

Customer's address (OPTIONAL)

statusstring · enumOptionalPossible values:

created_atstring · date-timeOptional

Timestamp when the customer was created.

edited_atstring · date-time · nullableOptional

Timestamp when the customer was last updated.

400

Returns 400 if the query is invalid

401

Returns 401 when authorization details is invalid

post

/v1/customers

HTTPcURLJavaScriptPython

POST /v1/customers HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 74

{
  "full_name": "text",
  "email": "text",
  "phone_number": "text",
  "address": "text"
}

application/jsontext/jsonapplication/*+json

{
  "id": "text",
  "full_name": "text",
  "email": "text",
  "phone_number": "text",
  "address": "text",
  "status": "active",
  "created_at": "2026-04-03T15:41:39.746Z",
  "edited_at": "2026-04-03T15:41:39.746Z",
  "dedicated_virtual_accounts": [
    {
      "id": "text",
      "is_live": true,
      "account_reference": "text",
      "gateway_code": "text",
      "callback_url": "text",
      "account_name": "text",
      "account_number": "text",
      "country": "text",
      "bank_code": "text",
      "bank_name": "text",
      "currency": "text",
      "bvn": "text",
      "metadata": "text",
      "created_at": "2026-04-03T15:41:39.746Z",
      "edited_at": "2026-04-03T15:41:39.746Z",
      "customer_id": "text",
      "payout_tag": "text",
      "payout_tag_description": "text",
      "payout_tag_metadata": "text"
    }
  ]
}