Conversation
Areteans
US
Last activity: 17 Dec 2025 5:20 EST
Issue Integrating React SDK with Next.js Application – 400 Error on Portal Load
Hi Team,
We are currently integrating the React SDK into a Next.js application and have followed the steps outlined in the official documentation: https://docs.pega.com/bundle/constellation-sdk/page/constellation-sdks/sdks/integrating-react-sdk-n…
Details:
- The integration was performed using version 25.
- After completing the setup and replacing the required files and code, the application starts successfully using
npm run startand launches at http://localhost:3000. - When navigating to https://localhost:3000/portal, we encounter a 400 Bad Request error.
- No API calls are visible in the browser’s Network tab.
- The project folder has been attached for your review.
Thanks,
Hemalatha
Pegasystems Inc.
PL
@hemalathag8810the 404 is a next.js routing error or call to Pega that is erroring out?
CREDERA
IN
@Kamil Janeczek Thanks for reply.
After loading the React SDK in the browser, the path changes from http://localhost:3000/ to http://localhost:3000/portal or http://localhost:3000/embedded, displaying the medico application based on our OAuth.
The same process works for the Next.js application? Which launches localhost (http://localhost:3050)correctly after running the command, but gives a 404 error when the path changes to "http://localhost:3050/portal" or "http://localhost:3050/embedded". For reference, please look at the above images. Thanks Akhilesh
Pegasystems Inc.
IN
@hemalathag8810 Please confirm if you have NextJS routes added for /embedded or /portal in your application.
Areteans
US
We are using Next.js version 16, in which the default routing system is available.
While setting up the Next.js SDK, the framework provides multiple configuration options. We have tried all the available options, but the same issue continues to occur.
We have attached the following screenshots for reference:
- Next.js CLI command
- Successful Next.js installation
package.jsonnpm run buildoutput- Network tab (issue observed when navigating to
/portal)