post
https://api.duodeal.app/api/customer-companies
Creates a new customer company (B2B client).
Body Fields
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Company legal name |
siret | string | No | SIRET number (French business ID) |
vatNumber | string | No | VAT identification number |
tradeName | string | No | Commercial/trade name |
address | object | No | Company address (see Address object below) |
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 |
state | string | No | State/region |
postCode | string | No | Postal code |
city | string | No | City name |
Response Fields
| Field | Type | Description |
|---|---|---|
id | integer | Newly created customer company unique identifier |
name | string | Company legal name |
siret | string | SIRET number |
vatNumber | string | VAT identification number |
tradeName | string | Commercial/trade name |
address | object | Company address |
archived | boolean | Archived status (default: false) |
customFields | object | Custom field values |
createdAt | datetime | Creation timestamp |
updatedAt | datetime | Last update timestamp |
Response
201 Created: Customer company 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
