{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"NinjaOne Endpoint Management Provider Configuration Guide","siteUrl":"https://docs.synqly.com","lang":"en-US"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"introduction","__idx":0},"children":["Introduction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["NinjaOne is a cloud-based platform for monitoring and managing endpoints. This guide shows you how to set up your NinjaOne instance and gather the values you need to configure the integration. NinjaOne authenticates with a Client ID and a Client Secret."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you begin, ensure that you have:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access to the web interface of NinjaOne"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access to a NinjaOne account with the system administrator role. Only system administrators can create API client apps"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"required-permissions","__idx":2},"children":["Required Permissions"]},{"$$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":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Monitoring"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve devices, the software installed on them, and their device health data"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Management"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Restart devices, scan for operating system and third-party software patches, and apply patches"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"generating-api-credentials","__idx":3},"children":["Generating API Credentials"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log in to NinjaOne with an account that has the system administrator role"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Administration > Apps > API"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client app IDs"]}," tab"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ Add client app"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fill in the field titled ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Name"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the dropdown titled ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Application Platform"]},", select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Services (machine-to-machine)"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the section titled ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Scopes"]},", select all of the required scopes. The required scopes can be found in the section above titled ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#required-permissions"},"children":["Required Permissions"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Leave the field titled ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Redirect URLs"]}," empty"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the section titled ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Allowed Grant Types"]},", select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client credentials"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},", then take note of the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Client Secret"]}," values and store them in a safe location"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You have now created a new NinjaOne API client app. Proceed to the next section titled ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#find-your-ninjaone-region"},"children":["Find Your NinjaOne Region"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information on NinjaOne API client apps, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.ninjaone.com/docs/application-programming-interface-api/oauth-token-configuration/"},"children":["NinjaOne API OAuth Token Configuration docs page"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"find-your-ninjaone-region","__idx":4},"children":["Find Your NinjaOne Region"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log in to NinjaOne"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Look at your browser's address bar. The address uses this format: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://{region}.ninjarmm.com"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Take note of the region: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["app"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["us2"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eu"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ca"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["oc"]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Other regions"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["NinjaOne also hosts instances on addresses outside this list, such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jp.ninjarmm.com"]},"."," ","If yours is one of them, set the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Base URL"]}," field when you configure the integration."," ","The integration ignores ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Region"]}," when you set ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Base URL"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configuring-the-integration","__idx":5},"children":["Configuring the Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To configure a new NinjaOne integration, provide each of the values as defined below:"]},{"$$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":"Integration Parameter"},"children":["Integration Parameter"]},{"$$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":["Client ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Client ID"]}," of the API client app you created"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Client Secret"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Client Secret"]}," of the same app"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Region"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your region code, such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["us2"]},". See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#find-your-ninjaone-region"},"children":["Find Your NinjaOne Region"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"optional-fields","__idx":6},"children":["Optional fields"]},{"$$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":"Integration Parameter"},"children":["Integration Parameter"]},{"$$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":["Base URL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Only set this if your NinjaOne address is not one of the regions listed above. Enter the address from your browser's address bar, up to and including ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".ninjarmm.com"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," Example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://jp.ninjarmm.com"]}]}]}]}]}]}]},"headings":[{"value":"Introduction","id":"introduction","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Required Permissions","id":"required-permissions","depth":2},{"value":"Generating API Credentials","id":"generating-api-credentials","depth":2},{"value":"Find Your NinjaOne Region","id":"find-your-ninjaone-region","depth":2},{"value":"Configuring the Integration","id":"configuring-the-integration","depth":2},{"value":"Optional fields","id":"optional-fields","depth":3}],"frontmatter":{"slug":"guides/provider-configuration/ninjaone-endpointmanagement-setup","seo":{"title":"NinjaOne Endpoint Management Provider Configuration Guide"}},"lastModified":"2026-11-11T16:00:16.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/provider-configuration/ninjaone-endpointmanagement-setup","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}