Getting started

View as MarkdownOpen in ClaudeOpen in ChatGPT

Find your clientId

Every API call and widget install needs a clientId. It identifies your project and starts with client_.

Logged in?

If you are signed in, every code snippet in these docs already shows your real clientId. Copy any snippet and it is ready to run.

Where it lives in the dashboard

  1. Onboarding: after signing up, the first screen shows your clientId inside the install snippets.
  2. Settings: open your project, then Settings. The integration snippets there contain your clientId.
  3. Any dashboard URL: the first path segment after usero.io/ is your clientId, for example usero.io/client_abc123/....

Verify it from the command line

The feedback endpoint accepts a GET to check that a clientId exists:

curl
curl "https://usero.io/api/feedback?clientId=YOUR_CLIENT_ID"

A valid id returns:

json
{ "valid": true, "settings": { "allowedDomains": [], "customization": {} } }

An unknown id returns 404 with {"valid": false}.

Note

One account can have multiple projects, each with its own clientId. Feedback is grouped per clientId in the dashboard, so use one per product (or per app) rather than sharing one id across unrelated projects.

Next

  • Quickstart: send your first feedback with one POST
  • Widget: drop-in feedback button, no form to build