---
title: "Create a new customer"
method: POST
path: "/api/customers"
tags: ["Customer"]
---

# Create a new customer

`POST /api/customers`

## Request body

- CustomerCreateDto — Details of customer to be created
  - `name` string, required — The name to give the customer. Must be unique to all active customers.
  - `customerCode` string, nullable — Unique identifier for this customer
  - `currencyCode` string, nullable — Currency code/denomination associated to this customer. If not provided, default to the primary currency code for the organization.
  - `creditLimit` number, double, nullable — Credit limit
  - `paymentTermsId` string, nullable — Payment terms.
  - `salesPersonId` string, nullable — Payment terms.
  - `url` string, uri, nullable — The Customer's website
  - `isTaxable` boolean, nullable — Whether or not this customer is taxable on Sales Orders and Quotes
  - `taxRateIds` string[], nullable — A list of tax codes to be automatically added to new SalesOrders for the customer when AutoAddTaxLineItems process setting is enabled.
  - `externalReferences` object, nullable — Arbitrary key-value-pair like data that can be used to later on search for the customer
  - `customFields` object, nullable — Custom fields that have been defined on this entity.
  - `notes` string, nullable — Notes associated to the customer.
  - `hasCustomerPortal` boolean, nullable — Indicates if this customer is set up to use the customer portal.

## Response `200`

Customer created

- CreatedResponseDto — Response for a created record
  - `id` string, required — The id of the created record

## Other responses

- `400` — Validation issues with input

---

[API](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi.md) · [All operations](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fulcrumpro/fulcrum-publicapi/versions/1b5649cff14a/schema)