Getting started

View as MarkdownOpen in ClaudeOpen in ChatGPT

Send your first feedback in 5 minutes

One POST. No SDK, no API key. Works from any language, any platform.

Step 1: Get your clientId

Your clientId identifies your project. It starts with client_.

  • Logged in? Every snippet on this page already shows your real clientId.
  • No account yet? Sign up free and your clientId is on the first screen. Until then, snippets show the placeholder YOUR_CLIENT_ID, swap it for your own before sending.

More detail: Find your clientId.

Step 2: Send a POST

curl -X POST https://usero.io/api/feedback \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "YOUR_CLIENT_ID",
    "rating": 4,
    "comment": "First feedback from the quickstart"
  }'

A successful response is:

json
{ "success": true, "feedbackId": "abc123" }

rating is 1 to 4 (1 Terrible, 2 Bad, 3 Good, 4 Amazing). Every submission needs a rating, a non-empty comment, or both. Full field list: POST /api/feedback reference.

Warning

Omit environment for your default environment. Do not send a placeholder like "no-env" or "default". The dashboard treats an absent environment as the default; a literal placeholder string creates a separate environment and your feedback will not appear in the default inbox.

Step 3: See it land

Open your dashboard and check the feedback inbox. Your POST shows up within a second or two. If you sent an environment value, switch the environment picker to that value to see it.

Or let your coding agent do it

Paste this prompt into Cursor, Claude Code, or any coding agent and it will build a feedback form wired to your account.

Agent prompt
# Task: Add Feedback Collection to This Project

Build a feedback UI that submits to Usero's API. The goal is to collect user satisfaction ratings and optional comments.

## What to build
A feedback form or prompt with:
- A 4-level rating (1 = Terrible, 2 = Bad, 3 = Good, 4 = Amazing)
- An optional comment text field
- A submit button that POSTs to the Usero API

## API Details
POST https://usero.io/api/feedback
Content-Type: application/json

### Request body
{
  "clientId": "YOUR_CLIENT_ID",   // required — your client ID
  "rating": 3,                      // required — 1 to 4
  "comment": "User's feedback",     // optional
  "environment": "production",      // optional — helps filter by env in dashboard
  "pageUrl": "https://...",         // optional — auto-detect from window.location
  "pageTitle": "...",               // optional — auto-detect from document.title
  "userEmail": "user@example.com"   // optional
}

### Response
200: { "success": true, "feedbackId": "abc123" }

## Working example
curl -X POST https://usero.io/api/feedback \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "YOUR_CLIENT_ID",
    "rating": 3,
    "comment": "Love the new dashboard!",
    "pageUrl": "https://yourapp.com/page",
    "environment": "production"
  }'

## Tips
- Auto-detect pageUrl and pageTitle from the browser so you get per-page feedback tracking.
- Set environment to distinguish production feedback from staging/dev.
- Show a success message after submission. Only clientId and rating are required.

Next steps