REST API (secure)
The apiSecret-authenticated submission endpoint, for your own backend or game server.
Meant to be called from somewhere that never reaches a browser — your own backend or a game server. apiSecret only ever appears in this dashboard and is never embedded in the widget or survey page, so leaking it would require your actual server being breached.
| Method & path | POST /api/v1/responses |
| Auth | Authorization: Bearer <apiSecret> |
| Rate limit | 50 requests / minute |
| Field | Required | Description |
|---|---|---|
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/v1/responses \ -H "Authorization: Bearer <apiSecret>" \ -H "Content-Type: application/json" \ -d '{ "score": 5, "type": "csat", "comment": "Great, thanks!" }'