Create Customer
Create a new customer in Customerscore.
For interactive API documentation, see the Swagger reference (opens in a new tab).
Endpoint
| Method | URL |
|---|---|
| POST | https://api.customerscore.io/api/v1/customer |
Request Body
Both external_id and name are always required when creating a customer.
| Field | Type | Required | Description |
|---|---|---|---|
external_id | string | Yes | Unique identifier for the customer in the external system |
name | string | Yes | Customer name |
Example Request
curl -X POST "https://api.customerscore.io/api/v1/customer" \
-H "Content-Type: application/json" \
-H "customerscore-key: your-generated-key" \
-d '{
"external_id": "12345",
"name": "Acme Corporation"
}'Response Codes
| Code | Description |
|---|---|
| 200 | The customer has been successfully created |
| 400 | Bad request |
| 401 | Unauthorized - Missing customerscore-key in the header |
| 403 | Forbidden - Invalid key |
| 405 | Method Not Allowed - Only POST method is allowed |
| 406 | Not Acceptable |