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

# Create a customer

`POST /customers`

## Request

- Base URL: `https://api.open-finance.ai/v3/loans`
- URL: `https://api.open-finance.ai/v3/loans/customers`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.open-finance.ai/oauth/token` scopes: `create:sessions`

## Request body

- object
  - `useCrm` boolean, required: Indicates whether CRM should be used
  - `syncData` boolean, required: Indicates whether data should be synchronized
  - `firstName` string: Customer's first name
  - `lastName` string: Customer's last name
  - `nationalId` string: Customer's national ID
  - `nationalIdIssueDate` string, date: The date when the national ID was issued
  - `email` string: Customer's email address
  - `phoneNumber` string: Customer's phone number
  - `birthDate` string, date: Customer's birth date
  - `businessId` string: Business ID if the customer is a business
  - `businessName` string: Business name if the customer is a business
  - `businessType` string: Type of business
  - `businessEstablishedDate` string, date: The date when the business was established
  - `activityArea` string: Area of business activity
  - `geoArea` string: Geographical area of the business
  - `cityName` string: City name where the customer is located
  - `streetName` string: Street name where the customer is located
  - `houseNumber` string: House number where the customer is located
  - `apartmentNumber` string: Apartment number where the customer is located
  - `postOfficeBox` string: Post office box number of the customer
  - `zipCode` string: Zip code where the customer is located

## Response `201`

Created

- object
  - `customerId` string: The unique identifier of the created customer

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `500`: Internal server error

---

[API](https://skmtc.dev/open-finance/apis/loans.md) - [All operations](https://skmtc.dev/open-finance/apis/loans/llms.txt) - [OpenAPI document](https://skmtc.dev/open-finance/apis/loans/revisions/915c69e62042?raw)