API
The Customerscore.io REST API lets you import and manage customer data, contacts, and product usage metrics programmatically. Use it when you need full control over what gets sent, or when your data lives somewhere without a ready-made integration.
Quick facts
| Setting | Value |
|---|---|
| Base URL | https://api.customerscore.io/api/v1 |
| Authentication | customerscore-key header |
| Content type | application/json |
| Rate limit | 500 requests per minute |
| Max body size | 5 MB |
Full details — how to generate a token, required headers, and rate limit responses — are in the API Introduction.
Endpoints
| Resource | Endpoints |
|---|---|
| Customers | Bulk upload, create, get, update, delete, and search |
| Contacts | Bulk upload, create, update, and delete |
See the full endpoint reference for a list of every method and URL.
Other ways to work with your data
- Webhooks — get notified when events happen instead of polling the API.
- Tracker — send product usage events from the browser or your backend.
- MCP Server — query customers, scores, and churn from an AI assistant.
- Integrations — connect Stripe, HubSpot, PostHog, and more without writing code.