Quickstart

From zero to your first analyzed feedback in ten minutes.

Choose how feedback comes in

#

Send your first feedback

#

Verify the key, then post an item. You get a 202 back instantly — analysis runs asynchronously and is usually ready in 2–5 seconds.

1 · Verify your key
curl https://app.sentriment.com/api/v1/ping \
  -H "Authorization: Bearer sk_live_…"
2 · Submit feedback
curl -X POST https://app.sentriment.com/api/v1/feedback \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-4231-note" \
  -d '{
    "text": "Checkout freezes when I apply a coupon",
    "userId": "usr_123",
    "email": "dana@acme.com",
    "metadata": { "plan": "pro", "page": "/checkout" }
  }'

Pass email now, thank yourself later

Sending email alongside userId lets Sentriment stitch this person together with their Intercom and Zendesk tickets automatically. See Identifying users.

Read the analysis

#

List your feedback back and you'll see each item enriched with sentiment, a type, emotions, detected language, and the cluster it was grouped into.

3 · Read it back
curl "https://app.sentriment.com/api/v1/feedback?limit=1" \
  -H "Authorization: Bearer sk_live_…"

# → sentiment, type, emotions, language, clusterId — per item

That's the whole loop. Open the dashboard and the item is already in the Feed, its theme forming in Clusters, and the user appearing under Users.

Where to go next

#
Was this page helpful?