---
title: "Create a customer account"
method: POST
path: "/profile/customers"
---

# Create a customer account

`POST /profile/customers`

## Request

- Base URL: `https://sandboxapi.fincra.com`
- URL: `https://sandboxapi.fincra.com/profile/customers`
- Auth: API key in header `api-key`
- TypeScript: <https://skmtc.dev/fincra/apis/awesome-new-api/docs/profile/customers/post.ts> (a function with typed inputs; its response is checked against the schema)

This Api helps to create a virtual card customer account

## Request body

- object
  - `identifier` string, required: An identifier is a name that identifies (that is, labels the identity of) either a unique object or a unique class of objects
  - `business` string, required: Your business id
  - `email` string, required: Email address. kindly note that it must be a unique email address
  - `firstName` string, required: The customer's first name.
  - `lastName` string, required: The customer's last name. This is required to create a virtual card account
  - `dob` string, required: The birthdate of the customer(YYYY-MM-DD )
  - `phone` object, required: This contains the country code and phone number of the customer
  - `address` object, required
  - `documents` object, required

## Response `200`

200

- object
  - `success` boolean
  - `message` string
  - `data` object
    - `middleName` string
    - `isActive` boolean
    - `phone` object
      - `countryCode` string
      - `number` string
      - `_id` string
    - `address` object
      - `country` string
      - `state` string
      - `street2` unknown
      - `zip` string
      - `city` string
      - `street` string
      - `_id` string
    - `_id` string
    - `identifier` string
    - `business` string
    - `email` string
    - `firstName` string
    - `lastName` string
    - `dob` string
    - `documents` object[]
      - `image` string
      - `type` string
      - `number` string
      - `issuedCountryCode` string
      - `issuedDate` string
      - `expirationDate` string
      - `_id` string
    - `cid` string
    - `createdAt` string
    - `updatedAt` string
    - `__v` integer

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `526b1509a02d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fincra/apis/awesome-new-api/changes/profile/customers/post.md)

---

[API](https://skmtc.dev/fincra/apis/awesome-new-api.md) - [All operations](https://skmtc.dev/fincra/apis/awesome-new-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fincra/apis/awesome-new-api/revisions/526b1509a02d?raw)