---
title: 'Create a customer'
description: 'Add a customer to a shop with the API.'
url: 'https://repender.nl/docs/api/customers/create-customer'
last_updated: '2026-11-10'
---

> Docs index: https://repender.nl/docs/llms.txt · MCP: https://repender.nl/docs/mcp · Skill: https://repender.nl/docs/skill.md

# Create a customer

This endpoint needs the Pro plan and works on the customers of the shop from the [shop context](https://repender.nl/docs/api.md#shop-context). See the [API overview](https://repender.nl/docs/api.md) for authentication and the rate limit.

`POST /customers`

Send the fields as JSON. Returns `201 Created` with the customer in `data`, in the same shape as in [list customers](https://repender.nl/docs/api/customers/list-customers.md).

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | Yes | Full name. Up to 255 characters. |
| `is_company` | boolean | Yes | Whether the customer is a company. |
| `company_name` | string | No | Up to 255 characters. |
| `postal_code` | string | No | Up to 255 characters. |
| `house_number` | integer | No |  |
| `house_number_addition` | string | No | Up to 255 characters. |
| `street` | string | No | Up to 255 characters. |
| `city` | string | No | Up to 255 characters. |
| `country_id` | integer | No | Id of an existing country. |
| `phone_number` | string | No | Up to 255 characters. |
| `email` | string | No | A valid email address. Up to 255 characters. |
| `invoice_email` | string | No | A valid email address. Up to 255 characters. |
| `registration_number` | string | No | Chamber of Commerce number. Up to 255 characters. |
| `vat_number` | string | No | Up to 255 characters. |
| `codice_fiscale` | string | No | Italian tax code. Up to 255 characters. |
| `remarks` | string | No | Free text. Up to 65535 characters. |