REST API (quick)
The apiKey-authenticated submission endpoint, callable straight from a browser.
Send scores straight to this endpoint from your own form or game client. apiKey is the same public key the widget uses, so if you have your own backend, prefer the secure (apiSecret) version instead.
| Method & path | POST /api/public/responses |
| Auth | apiKey field in the request body |
| Rate limit | 50 requests / minute |
| Field | Required | Description |
|---|---|---|
apiKey | required | This project's identifier, from the API key card above |
score | required | The score for the scale (1-5 for CSAT/CES, 0-10 for NPS) |
type | optional | If surveying multiple scales, which one this score is for. Defaults to the primary scale. |
comment, email, segment, trigger | optional | Optional fields |
curl -X POST https://yourdomain.com/api/public/responses \ -H "Content-Type: application/json" \ -d '{ "apiKey": "<your project's apiKey>", "score": 5, "type": "csat", "comment": "Great, thanks!" }'