Step 2 — Receive code on your callback (browser leg, no Postman action)
Overview
⚠️ Browser leg — not a Postman-callable request
This step happens entirely in the user's browser. Review Management redirects the browser back to the redirect_uri you registered with us, appending two query params:
code— a short-lived authorization code (single-use, expires in ~10 minutes).state— the exact random string your server sent in Step 1.
What your server must do when the callback hits
- Verify
statematches the value you stored in the user's session before the Step-1 redirect. If it doesn't match, abort the flow — it's a CSRF attempt. - Capture
codeand immediately call Step 3 (Exchange code for token) from your backend. Do NOT send the code from the browser. codeis single-use and short-lived — exchange it within seconds of receipt.
Why no Postman request here
There is no API call for this step. The browser receives the 302 response from Review Management's /oauth/authorize and follows it to your redirect_uri. Your application is the receiver — Review Management has no further role until you call Step 3.
This entry exists for documentation continuity between Step 1 and Step 3 — it cannot be executed.
Prerequisites
- No authentication — this endpoint is public.
- Values for the required query parameters
code,state— see the table below.
Base URL
| Environment | URL |
|---|---|
| Production | https://production-api.shoutaboutus.com |
| Development | https://development-api.shoutaboutus.com |
Endpoint
GET {your-registered-redirect-uri} — this is your callback URL, not an endpoint on this API
Authentication
- No bearer token required.
Rate limit
- This endpoint does not declare a rate limit.
Query parameters
| Parameter | Required | Description |
|---|---|---|
code | Required | The one-time authorization code Review Management appended to your registered redirect_uri. |
state | Required | Echoed back verbatim. Compare it against the value you stored in step 1 to prevent CSRF. |
Errors
| Status | Meaning |
|---|---|
500 | Unexpected server error |
Example request
Open this URL in the user's browser — it is a top-level redirect, not a call your code makes:
https://yourapp.com/callback?code=THE_CODE_FROM_REVIEW_MANAGEMENT&state=RANDOM_STRINGUpdated 18 days ago
Did this page help you?
