{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-agen-for-work/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["Notification"]},"type":"markdown"},"seo":{"title":"NetSuite integration","siteUrl":"https://developers.frontegg.com/","llmstxt":{"title":"Frontegg Developer Documentation","description":"Authentication, authorization, and user management for Customer Identity, plus Agen for SaaS and Agen for Work. Guides, SDKs, and API references.","sections":[{"title":"Customer Identity (CIAM)","description":"Auth, SSO, SCIM, entitlements, and user management — guides, SDKs, and APIs.","includeFiles":["ciam/**/*.md"],"excludeFiles":[]},{"title":"Agen for SaaS","description":"Agentic access and authorization for SaaS products.","includeFiles":["agen-for-saas/**/*.md"],"excludeFiles":[]},{"title":"Agen for Work","description":"Agentic access and authorization for internal and workforce use.","includeFiles":["agen-for-work/**/*.md"],"excludeFiles":[]},{"title":"Platform","description":"Shared platform overview.","includeFiles":["platform/**/*.md"],"excludeFiles":[]}],"excludeFiles":["internal-docs/**","ciam/guides/env-settings/inject-client-ip.md","CLAUDE.md",".claude/**","**/images/**"],"hide":false}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"netsuite-integration","__idx":0},"children":["NetSuite integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["NetSuite is Oracle's cloud ERP suite for finance, operations, and CRM. Integrating NetSuite with Frontegg lets your application read and write NetSuite records and run SuiteQL queries through the SuiteTalk REST Web Services API on behalf of your users — all through Frontegg's integration layer. NetSuite authenticates with OAuth 2.0 (Authorization Code flow), so you create an integration record in NetSuite to obtain a Client ID and Client Secret. Because NetSuite endpoints are per-account, you also provide your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NetSuite Account ID"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Prerequisites","type":"attention"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.netsuite.com/"},"children":["NetSuite"]}," account with administrator access"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["REST Web Services"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth 2.0"]}," features enabled (see Step 1)"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connect-to-netsuite","__idx":1},"children":["Connect to NetSuite"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You create an integration record in NetSuite. It provides the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," (Consumer Key) and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}," (Consumer Secret) and defines the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["redirect URI"]}," that NetSuite returns users to after they authorize access. You also need your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Account ID"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-1-enable-the-required-features","__idx":2},"children":["Step 1: Enable the required features"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sign in to NetSuite as an administrator and go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Setup → Company → Enable Features"]},". On the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SuiteCloud"]}," tab, enable ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["REST Web Services"]}," and, under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage Authentication"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth 2.0"]},". Save."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-2-create-an-integration-record","__idx":3},"children":["Step 2: Create an integration record"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Setup → Integration → Manage Integrations → New"]},". Enter a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]}," (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Frontegg Integration"]},") and set ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["State"]}," to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enabled"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-3-configure-oauth-20","__idx":4},"children":["Step 3: Configure OAuth 2.0"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the integration record, under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth 2.0"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enable ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authorization Code Grant"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enable the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["REST Web Services"]}," scope."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redirect URI"]}," to your Frontegg Redirect URL: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://YOUR_MCP_GATEWAY_URL/integration-callback"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Make sure the Token-Based Authentication options are not required for this app — only OAuth 2.0 is needed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-4-copy-the-client-id-and-client-secret","__idx":5},"children":["Step 4: Copy the Client ID and Client Secret"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},". NetSuite displays the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," (Consumer Key) and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}," (Consumer Secret) on the confirmation page."]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Copy your credentials now","type":"attention"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Client ID and Client Secret are shown only once, right after you save the integration record. Copy them immediately and store them securely — treat them like a password. If you lose them, reset the credentials on the integration record to generate new ones."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-5-find-your-account-id","__idx":6},"children":["Step 5: Find your Account ID"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Account ID"]}," appears in your NetSuite URL (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1234567"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1234567.app.netsuite.com"]},") and in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Setup → Company → Company Information"]},". Use lowercase, replace any underscore with a hyphen, and append the environment suffix for non-production accounts (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1234567-sb1"]}," for a sandbox). Do not include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".suitetalk.api.netsuite.com"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configure-the-frontegg-portal","__idx":7},"children":["Configure the Frontegg portal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you have your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]},", and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Account ID"]},", configure the integration in the Frontegg portal:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Frontegg portal"]}," and navigate to [ENVIRONMENT] → Integrations → NetSuite."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NetSuite Account ID"]}," (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1234567"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Frontegg requests the following scope during authorization:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Scope"},"children":["Scope"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rest_webservices"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Access NetSuite records and run SuiteQL queries via SuiteTalk REST Web Services"]}]}]}]}]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Keep your credentials secure","type":"attention"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Never share or commit your Client Secret to version control."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additional-resources","__idx":8},"children":["Additional resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/chapter_1540391670.html"},"children":["SuiteTalk REST Web Services documentation"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_158074210415.html"},"children":["OAuth 2.0 for REST Web Services (NetSuite)"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/agen-for-work/connectors/redirect-url"},"children":["How to get your Redirect URL"]}]}]}]}]},"headings":[{"value":"NetSuite integration","id":"netsuite-integration","depth":2},{"value":"Connect to NetSuite","id":"connect-to-netsuite","depth":3},{"value":"Step 1: Enable the required features","id":"step-1-enable-the-required-features","depth":4},{"value":"Step 2: Create an integration record","id":"step-2-create-an-integration-record","depth":4},{"value":"Step 3: Configure OAuth 2.0","id":"step-3-configure-oauth-20","depth":4},{"value":"Step 4: Copy the Client ID and Client Secret","id":"step-4-copy-the-client-id-and-client-secret","depth":4},{"value":"Step 5: Find your Account ID","id":"step-5-find-your-account-id","depth":4},{"value":"Configure the Frontegg portal","id":"configure-the-frontegg-portal","depth":3},{"value":"Additional resources","id":"additional-resources","depth":3}],"frontmatter":{"category":"Finance","seo":{"title":"NetSuite integration"}},"lastModified":"2026-07-29T14:27:20.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/agen-for-work/connectors/marketplace/netsuite","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}