---
title: "Add customer"
method: POST
path: "/customers"
tags: ["Customers"]
---

# Add customer

`POST /customers`

## Request body

- StoreCustomerRequest
  - `name` string, required — The customer name
  - `name_addon` string — The customer name addon
  - `customer_number` string — The customer number. Enter '(auto)' for automatic set if possible.
  - `info` string — The customer info
  - `source` string — The customer source
  - `source_external_id` string — The customer source external id

## Response `201`

The resource was successfully created.

## Other responses

- `401` — The request lacks valid authentication credentials.
- `403` — The token is valid but lacks the permission for this action.
- `422` — The request was well-formed but contains semantic errors (validation failed).
- `500` — An unexpected error occurred on the server (e.g. a requested relation does not exist).

## Changes

- **2026-09-03** `60bb67970e41` — 3 info
  - added the optional property `error/display_message` to the response with the `401` status
  - added the optional property `error/display_message` to the response with the `403` status
  - added the optional property `error/display_message` to the response with the `500` status

[Change history](https://skmtc.dev/craftboxx/apis/craftboxx-api-documentation/changes/customers/post.md)

---

[API](https://skmtc.dev/craftboxx/apis/craftboxx-api-documentation.md) · [All operations](https://skmtc.dev/craftboxx/apis/craftboxx-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/craftboxx/craftboxx-api-documentation/revisions/60bb67970e41/schema)