post
https://api.duodeal.app/api/customers
Creates a new customer (contact).
Body Fields
| Field | Type | Required | Description |
|---|---|---|---|
firstName | string | No | Customer first name |
lastName | string | No | Customer last name |
email | string | No | Customer email address |
civility | string | No | Civility/title (Mr, Mrs, etc.) |
phone | string | No | Primary phone number |
jobTitle | string | No | Job title/position |
billingAddress | object | No | Billing address (see Address object below) |
differentDeliveryAddress | boolean | No | Set to true if delivery address differs |
deliveryAddress | object | No | Delivery address (required if differentDeliveryAddress is true) |
customerCompany | object | No | Link to customer company: {"id": companyId} |
customFields | object | No | Custom field values |
Address Object
| Field | Type | Required | Description |
|---|---|---|---|
country | string | No | Country code (e.g., FR, US) |
address | string | No | Street address |
postCode | string | No | Postal code |
city | string | No | City name |
Response Fields
| Field | Type | Description |
|---|---|---|
id | integer | Newly created customer unique identifier |
number | string | Auto-generated customer reference number |
firstName | string | Customer first name |
lastName | string | Customer last name |
fullName | string | Computed full name |
email | string | Customer email address |
archived | boolean | Archived status (default: false) |
createdAt | datetime | Creation timestamp |
updatedAt | datetime | Last update timestamp |
Response
201 Created: Customer successfully created400 Bad Request: Invalid request body or validation error401 Unauthorized: Invalid or missing API key
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
201Resource created
400Bad request
401Unauthorized
