Sign in
public.customers

Create Customer

Creates a new customer or returns the existing customer for the authenticated merchant.

post/v1/customers

Request body

emailstring required
first_namestring
last_namestring

Example request

{
  "email": "customer@example.com",
  "first_name": "John",
  "last_name": "Doe"
}

Response

Created

created_atstring
emailstring
first_namestring
idstring
is_verifiedboolean
last_namestring
rejection_reasonsstring[]

RejectionReasons contains the current blocking verification/capability issues. It is empty after approval.

tier_1_kyc_completeboolean
tier_2_kyc_completeboolean
updated_atstring

Example response

{
  "capabilities": [
    {
      "name": "base",
      "status": "approved"
    }
  ],
  "created_at": "2025-01-05T15:04:05Z",
  "email": "customer@example.com",
  "first_name": "John",
  "id": "650e8400-e29b-41d4-a716-446655440000",
  "last_name": "Doe",
  "paystack_funding_account_readiness": {
    "account_number_last4": "6789",
    "bank_code": "058",
    "status": "READY",
    "updated_at": "2026-08-10T12:00:00Z"
  },
  "updated_at": "2025-01-05T15:04:05Z"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.