- Your backend verifies the session of the new account, and maps the verified claims to
auth_context. - It creates the API key of the account, inactive.
- It calls
POST /v1/assessmentswith flowaccount_creationand the SHA-256 of the key. - It applies the decision:
blockrefuses,allowgrants,step_upasks for a second factor andreviewholds the account.
Create a workspace
Create your workspace with your email address. One call creates it and immediately answers its test key. Thus you or your agent can start before anyone opens a mailbox.To give the workspace a name, such as the name of your company, add The data that you create with a test key stays in your test environment, separate from live data. You build this full page on the test key. In the last step you change to a live key (The answer has
Create a workspace
Response
workspace_name to the body: {"email":"you@example.com","workspace_name":"Acme"}. Without it, the workspace has no name until you give it one in the console.The test key starts with nrk_test_. NoResponse shows it once, so store it now. It carries the assess, history, delete, webhooks, integrations and groups scopes. assess covers every call on this page: it creates the assessment and polls it with wait.A test key calls the same API as a live key, but a deterministic simulator answers it. NoResponse looks up no source and charges nothing. Magic emails such as
step_up@test.noresponse.org and block@test.noresponse.org give each decision when you want it. Test your integration lists every magic identifier.nrk_live_). Test and live environments explains the two environments.The live key comes from the email that we send to your address. Open its link, or post the token from it:Claim the live key
status active and your live_key. NoResponse shows the live key once. Some workspace creations answer status held instead. We then examine the workspace, and email you a link that claims the live key after we approve it. Your test key works during this time.If our own assessment blocks the creation, it answers 403 workspace_refused and gives no key. While your verification link waits unopened, a second call for the same address answers 409 signup_pending and makes nothing. The link works for 24 hours. One address can create a workspace 3 times an hour.Set your keys
Put your keys in the environment of your backend, next to the keys of your auth provider. Keep all of them out of browser and mobile code.The NoResponse SDKs read
- Clerk
- WorkOS
- Auth0
- Your own login
Environment
NORESPONSE_API_KEY and call https://api.noresponse.org. You set nothing more for NoResponse.Install the SDKs
Install the NoResponse SDK and the SDK of your auth provider. WorkOS and Auth0 sessions are JSON Web Tokens, so those tabs add a JWT library to verify them. With your own login, you install only the NoResponse SDK.The NoResponse SDKs need Node.js 20, Python 3.10 or Go 1.24 or later. Of the provider packages,
- Clerk
- WorkOS
- Auth0
- Your own login
TypeScript
@workos-inc/node needs Node.js 22.11, the Go JWT module needs Go 1.25, and the Go Auth0 module needs Go 1.26.Verify the session and map it
Your backend verifies the session with the SDK of your auth provider. Then it reads the user record for the facts that the token does not hold. The NoResponse adapter changes the verified claims and those facts into With an auth provider, the adapter reads these facts from the claims: the session id, organisation, roles, second factor and impersonation. Pass your auth session lists each field that each adapter maps, and the session facts that you can add.
auth_context. NoResponse refuses raw tokens, so only verified claims leave your backend.The account id is the user id from your auth provider, sent without change. The gate looks up the email address of the account. Thus verifyNewAccount refuses a user without one.- Clerk
- WorkOS
- Auth0
- Your own login
Use the Clerk session token that your frontend sends. Clerk’s
getToken() returns it. Send it in the Authorization: Bearer header.Replace https://app.example.com with the origin of your frontend. Clerk compares it with the azp claim of the token.TypeScript
Call NoResponse
Run this in the backend route that grants the credits or the first API key, before it grants them. From here, the code is the same for every auth provider and for your own login.The answer starts with
- Create the API key of the account and store it inactive.
- Send the SHA-256 of the key as
issued_credential.sha256. The key never leaves your backend. - Make the Idempotency-Key from the key id.
issuedCredential. Make the Idempotency-Key from your own id for the grant. With your own login, newAccount.authContext is empty, and the SDK does not send auth_context.flow names the flow that you assess: account_creation here, login at login and purchase at purchase. The samples do not send depth. Thus account creation gets the default full, which waits up to 3,000 ms for the sources. quick waits only for the sources that answer within 500 ms. It is the default for login.In the samples:tokenis the token from step 4: the Clerk session token, WorkOS access token, Auth0 ID token or your own session token.clientIpis the address of the user, as your load balancer reports it.apiKeysis your own key store.
TypeScript
account, the one current risk of the account. It holds the score, the decision for this flow and the reasons for them. This is the part that you act on. The facts of this assessment alone are under detail, for example its status, confidence and incomplete sources.Response
detail has more fields than shown here. The assessment describes each one.A 4xx answer raises a typed error in every SDK:- A 400 names the field that it refused in
invalid_params. - A 401 means that the key is missing or revoked.
- A 403 means that the key does not have the
assessscope.
Act on the answer
Act on Call A timeout, a 429 or a 503 from NoResponse also has no decision. The SDKs retry those for up to 30 seconds, and then raise an error. Keep the key inactive. From a background job, retry
account.risk.decision. Your code decides. NoResponse never blocks an account creation itself.Any decision that the SDK does not recognise goes to review.
apiKeys, credits and reviewQueue are your own code.TypeScript
act with the answer from step 5. When it returns pending, do these steps:- Tell the user that you are setting up the account.
- In a background job, wait for the final answer.
- Call
actagain.
wait polls until the status of the assessment is complete. It polls at the interval that the Retry-After of the API gives, and at most once a second. It stops after a timeout, 30 seconds unless you set a different one.- If the answer is
partialat the timeout,waitreturns it with its status stillpartial.actthen runs on its recommendation. - If the answer is still
pending,waitraises a timeout error that carries the pending answer.
account.risk_changed webhook delivers the final decision.TypeScript
assessments.create with the same key, the same body and the same Idempotency-Key.Check it on the simulator
Keep the test key set. Create one account for each row below, with the email as the address of the user. The route calls
verifyNewAccount, then NoResponse, then act.Log the id of each answer. It starts with asm_. If the answer has an account, also log account.risk.score and account.risk.decision. A first answer that is still pending has no account. To use an address again for a different account, add a +tag, as in allow+2@test.noresponse.org.The last row is the late result: an answer that has more risk after the gate acted. The gate on this page acts on the first answer, so it grants. The final answer raises the account’s decision to
review, and NoResponse sends account.risk_changed. Admission and late decisions shows how the SDK enforces it.With your own login, give the SDK one function for each action, as Your own login shows.Every simulated answer carries a
test_scenario reason. Use it to tell a simulated answer from a live one.Go live
- Set
NORESPONSE_API_KEYto the live key from your verified email (step 1). - Create a new account with your own email address.
test_scenario reason. A second account with the same email fires the seen_before reason. For a clean first answer, use a new address.Every answer carries an X-Request-ID header. Quote it, or the assessment id, when you write to us about an answer.To examine an answer, open the console and find its asm_ id on Assessments. You can also press ⌘K and paste the id. The assessment shows its score and reasons, its account, and the websites that held each identifier.Next steps
Turn an assessment into a decision
Tune the rules. Add rules on reasons and confidence.
Webhooks
Receive late answers.
Pass your auth session
Send the session facts that the quickstart does not send.
Report outcomes
Tell NoResponse the outcome of each account, so that later scores improve.