Create Contact
Create a new contact 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/{customerExternalId}/contact |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
customerExternalId | string | Yes | Customer external ID |
Request Body
Both external_id and name are always required when creating a contact.
| Field | Type | Required | Description |
|---|---|---|---|
external_id | string | Yes | Unique identifier for the contact in the external system |
name | string | Yes | Contact name |
Example Request
curl -X POST "https://api.customerscore.io/api/v1/customer/12345/contact" \
-H "Content-Type: application/json" \
-H "customerscore-key: your-generated-key" \
-d '{
"external_id": "C12345",
"name": "John Doe"
}'Response Codes
| Code | Description |
|---|---|
| 200 | The contact has been successfully created |
| 400 | Bad request |
| 401 | Unauthorized - Missing customerscore-key in the header |
| 403 | Forbidden - Invalid key |
| 404 | Customer not found |
| 405 | Method Not Allowed - Only POST method is allowed |
| 406 | Not Acceptable |