Skip to main content

Solarwinds Service Desk

SolarWinds Service Desk is a cloud-based IT service management (ITSM) platform for incident management, IT asset management, change management, and service catalog operations. This connector lets you ingest records such as incidents, users, assets, and changes, and send data back to create or update incidents, users, changes, and assets in SolarWinds Service Desk.

Solarwinds Service Desk icon

Power end-to-end data operations for your Solarwinds Service Desk API with Nexla. Our bi-directional Solarwinds Service Desk connector is purpose-built for Solarwinds Service Desk, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Solarwinds Service Desk or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Solarwinds Service Desk workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

  • Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
  • Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
  • API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
  • Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites

Before creating a SolarWinds Service Desk credential, you need a JSON Web Token (JWT) from your SolarWinds Service Desk account. SolarWinds Service Desk (formerly Samanage) uses token-based authentication, and the token carries the same permissions as the role of the user who generated it. Only administrators can generate tokens.

To obtain your JSON Web Token, follow these steps:

  1. Sign in to SolarWinds Service Desk with an administrator account.

  2. Navigate to Setup > Users & Groups > Users and open your User detail page (not your User Profile Card). You can also use the search bar to go directly to your user, then click your name to open the details.

  3. On the user detail page, click Actions and select Generate JSON Web Token from the dropdown menu.

  4. Under JSON Web Token, click Copy to copy the generated token to your clipboard.

  5. Store the token securely, as you will need it to configure your Nexla credential. If the token is ever compromised, return to this page and use Reset to invalidate the old token and issue a new one.

The token is sent in the X-Samanage-Authorization header (as Bearer <token>) for API requests. Because the token inherits the permissions of the generating user's role, ensure that user has the access required for the resources you plan to read or write. For more information, see the SolarWinds Service Desk API Documentation.

Authenticate

Credentials required

FieldRequiredSecretDescription
API KeyYesYesYour SolarWinds Service Desk JSON Web Token (JWT), generated from your user detail page under Setup > Users & Groups > Users > Actions > Generate JSON Web Token.

Create a credential in Nexla

  1. After selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

  2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

  3. Enter your JSON Web Token in the API Key field. This is the token you generated in Prerequisites and must be kept confidential.

    The token carries the same permissions as the role of the user who generated it. If the token is compromised, reset it from the user detail page in SolarWinds Service Desk to invalidate the old token and issue a new one.

    For detailed information about token authentication and available endpoints, see the SolarWinds Service Desk API Documentation.

  4. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation.

Use as a data source

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Solarwinds Service Desk connector tile, then select the credential that will be used to connect to the SolarWinds Service Desk instance, and click Next; or, create a new Solarwinds Service Desk credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common SolarWinds Service Desk endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

[Rest API] List Users

This endpoint template retrieves records from the users resource in your SolarWinds Service Desk account. Use this template when you need to ingest this data for analysis, reporting, or synchronization with other systems.

  • Retrieve users. Nexla automatically paginates through the results to fetch all available records.

This endpoint returns data from the SolarWinds Service Desk REST API. For detailed information about response fields, filtering, and pagination, see the SolarWinds Service Desk API Documentation.

[Rest API] List Purchase Orders

This endpoint template retrieves records from the purchase orders resource in your SolarWinds Service Desk account. Use this template when you need to ingest this data for analysis, reporting, or synchronization with other systems.

  • Retrieve purchase_orders. Nexla automatically paginates through the results to fetch all available records.

This endpoint returns data from the SolarWinds Service Desk REST API. For detailed information about response fields, filtering, and pagination, see the SolarWinds Service Desk API Documentation.

[Rest API] List Groups

This endpoint template retrieves records from the groups resource in your SolarWinds Service Desk account. Use this template when you need to ingest this data for analysis, reporting, or synchronization with other systems.

  • Retrieve groups. Nexla automatically paginates through the results to fetch all available records.

This endpoint returns data from the SolarWinds Service Desk REST API. For detailed information about response fields, filtering, and pagination, see the SolarWinds Service Desk API Documentation.

[Rest API] List Roles

This endpoint template retrieves records from the roles resource in your SolarWinds Service Desk account. Use this template when you need to ingest this data for analysis, reporting, or synchronization with other systems.

  • Retrieve roles. Nexla automatically paginates through the results to fetch all available records.

This endpoint returns data from the SolarWinds Service Desk REST API. For detailed information about response fields, filtering, and pagination, see the SolarWinds Service Desk API Documentation.

[Rest API] List Hardwares

This endpoint template retrieves records from the hardwares resource in your SolarWinds Service Desk account. Use this template when you need to ingest this data for analysis, reporting, or synchronization with other systems.

  • Retrieve hardwares. Nexla automatically paginates through the results to fetch all available records.

This endpoint returns data from the SolarWinds Service Desk REST API. For detailed information about response fields, filtering, and pagination, see the SolarWinds Service Desk API Documentation.

[Rest API] List Risks

This endpoint template retrieves records from the risks resource in your SolarWinds Service Desk account. Use this template when you need to ingest this data for analysis, reporting, or synchronization with other systems.

  • Retrieve risks. Nexla automatically paginates through the results to fetch all available records.

This endpoint returns data from the SolarWinds Service Desk REST API. For detailed information about response fields, filtering, and pagination, see the SolarWinds Service Desk API Documentation.

[Rest API] List Audits

This endpoint template retrieves records from the audits resource in your SolarWinds Service Desk account. Use this template when you need to ingest this data for analysis, reporting, or synchronization with other systems.

  • Retrieve audits. Nexla automatically paginates through the results to fetch all available records.

This endpoint returns data from the SolarWinds Service Desk REST API. For detailed information about response fields, filtering, and pagination, see the SolarWinds Service Desk API Documentation.

[Rest API] List Vendors

This endpoint template retrieves records from the vendors resource in your SolarWinds Service Desk account. Use this template when you need to ingest this data for analysis, reporting, or synchronization with other systems.

  • Retrieve vendors. Nexla automatically paginates through the results to fetch all available records.

This endpoint returns data from the SolarWinds Service Desk REST API. For detailed information about response fields, filtering, and pagination, see the SolarWinds Service Desk API Documentation.

[Rest API] List Contracts

This endpoint template retrieves records from the contracts resource in your SolarWinds Service Desk account. Use this template when you need to ingest this data for analysis, reporting, or synchronization with other systems.

  • Retrieve contracts. Nexla automatically paginates through the results to fetch all available records.

This endpoint returns data from the SolarWinds Service Desk REST API. For detailed information about response fields, filtering, and pagination, see the SolarWinds Service Desk API Documentation.

[Rest API] List Assets

This endpoint template retrieves records from the assets resource in your SolarWinds Service Desk account. Use this template when you need to ingest this data for analysis, reporting, or synchronization with other systems.

  • Retrieve assets. Nexla automatically paginates through the results to fetch all available records.

This endpoint returns data from the SolarWinds Service Desk REST API. For detailed information about response fields, filtering, and pagination, see the SolarWinds Service Desk API Documentation.

[Rest API] List Mobiles

This endpoint template retrieves records from the mobiles resource in your SolarWinds Service Desk account. Use this template when you need to ingest this data for analysis, reporting, or synchronization with other systems.

  • Retrieve mobiles. Nexla automatically paginates through the results to fetch all available records.

This endpoint returns data from the SolarWinds Service Desk REST API. For detailed information about response fields, filtering, and pagination, see the SolarWinds Service Desk API Documentation.

[Rest API] List Categories

This endpoint template retrieves records from the categories resource in your SolarWinds Service Desk account. Use this template when you need to ingest this data for analysis, reporting, or synchronization with other systems.

  • Retrieve categories. Nexla automatically paginates through the results to fetch all available records.

This endpoint returns data from the SolarWinds Service Desk REST API. For detailed information about response fields, filtering, and pagination, see the SolarWinds Service Desk API Documentation.

[Rest API] List Departments

This endpoint template retrieves records from the departments resource in your SolarWinds Service Desk account. Use this template when you need to ingest this data for analysis, reporting, or synchronization with other systems.

  • Retrieve departments. Nexla automatically paginates through the results to fetch all available records.

This endpoint returns data from the SolarWinds Service Desk REST API. For detailed information about response fields, filtering, and pagination, see the SolarWinds Service Desk API Documentation.

[Rest API] List Sites

This endpoint template retrieves records from the sites resource in your SolarWinds Service Desk account. Use this template when you need to ingest this data for analysis, reporting, or synchronization with other systems.

  • Retrieve sites. Nexla automatically paginates through the results to fetch all available records.

This endpoint returns data from the SolarWinds Service Desk REST API. For detailed information about response fields, filtering, and pagination, see the SolarWinds Service Desk API Documentation.

[Rest API] List Configuration Items

This endpoint template retrieves records from the configuration items resource in your SolarWinds Service Desk account. Use this template when you need to ingest this data for analysis, reporting, or synchronization with other systems.

  • Retrieve configuration_items. Nexla automatically paginates through the results to fetch all available records.

This endpoint returns data from the SolarWinds Service Desk REST API. For detailed information about response fields, filtering, and pagination, see the SolarWinds Service Desk API Documentation.

[Rest API] List Solutions

This endpoint template retrieves records from the solutions resource in your SolarWinds Service Desk account. Use this template when you need to ingest this data for analysis, reporting, or synchronization with other systems.

  • Retrieve solutions. Nexla automatically paginates through the results to fetch all available records.

This endpoint returns data from the SolarWinds Service Desk REST API. For detailed information about response fields, filtering, and pagination, see the SolarWinds Service Desk API Documentation.

[Rest API] List Releases

This endpoint template retrieves records from the releases resource in your SolarWinds Service Desk account. Use this template when you need to ingest this data for analysis, reporting, or synchronization with other systems.

  • Retrieve releases. Nexla automatically paginates through the results to fetch all available records.

This endpoint returns data from the SolarWinds Service Desk REST API. For detailed information about response fields, filtering, and pagination, see the SolarWinds Service Desk API Documentation.

[Rest API] List Change Catalogs

This endpoint template retrieves records from the change catalogs resource in your SolarWinds Service Desk account. Use this template when you need to ingest this data for analysis, reporting, or synchronization with other systems.

  • Retrieve change_catalogs. Nexla automatically paginates through the results to fetch all available records.

This endpoint returns data from the SolarWinds Service Desk REST API. For detailed information about response fields, filtering, and pagination, see the SolarWinds Service Desk API Documentation.

[Rest API] List Changes

This endpoint template retrieves records from the changes resource in your SolarWinds Service Desk account. Use this template when you need to ingest this data for analysis, reporting, or synchronization with other systems.

  • Retrieve changes. Nexla automatically paginates through the results to fetch all available records.

This endpoint returns data from the SolarWinds Service Desk REST API. For detailed information about response fields, filtering, and pagination, see the SolarWinds Service Desk API Documentation.

[Rest API] List Incidents

This endpoint template retrieves records from the incidents resource in your SolarWinds Service Desk account. Use this template when you need to ingest this data for analysis, reporting, or synchronization with other systems.

  • Retrieve incidents. Nexla automatically paginates through the results to fetch all available records.

This endpoint returns data from the SolarWinds Service Desk REST API. For detailed information about response fields, filtering, and pagination, see the SolarWinds Service Desk API Documentation.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration

Solarwinds Service Desk data sources can also be manually configured to ingest data from any valid SolarWinds Service Desk API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new Solarwinds Service Desk data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.

Use as a destination

Click the + icon on the Nexset that will be sent to the Solarwinds Service Desk destination, and select the Send to Destination option from the menu. Select the Solarwinds Service Desk connector from the list of available destination connectors, then select the credential that will be used to connect to the SolarWinds Service Desk instance, and click Next; or, create a new Solarwinds Service Desk credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure destinations to send data to common SolarWinds Service Desk endpoints. Select the endpoint to which data will be sent from the Endpoint pulldown menu. Then, click on the template in the list below to expand it, and follow the instructions to configure additional endpoint settings.

[Rest API] Create Incident

Create a new incident in SolarWinds Service Desk. Each record from your Nexset is sent as a separate API request.

  • This endpoint sends data as JSON in the request body. Ensure your Nexset records include the fields required by the SolarWinds Service Desk API for this operation.

The record structure must match the format expected by the SolarWinds Service Desk API. For detailed information about request body formats and available fields, see the SolarWinds Service Desk API Documentation.

[Rest API] Update Incident

Update an existing incident by ID in SolarWinds Service Desk. Each record from your Nexset is sent as a separate API request.

  • This endpoint sends data as JSON in the request body. Ensure your Nexset records include the fields required by the SolarWinds Service Desk API for this operation.

The record structure must match the format expected by the SolarWinds Service Desk API. For detailed information about request body formats and available fields, see the SolarWinds Service Desk API Documentation.

[Rest API] Create User

Create a new user in SolarWinds Service Desk. Each record from your Nexset is sent as a separate API request.

  • This endpoint sends data as JSON in the request body. Ensure your Nexset records include the fields required by the SolarWinds Service Desk API for this operation.

The record structure must match the format expected by the SolarWinds Service Desk API. For detailed information about request body formats and available fields, see the SolarWinds Service Desk API Documentation.

[Rest API] Create Change

Create a new change request in SolarWinds Service Desk. Each record from your Nexset is sent as a separate API request.

  • This endpoint sends data as JSON in the request body. Ensure your Nexset records include the fields required by the SolarWinds Service Desk API for this operation.

The record structure must match the format expected by the SolarWinds Service Desk API. For detailed information about request body formats and available fields, see the SolarWinds Service Desk API Documentation.

[Rest API] Create Asset

Create a new hardware asset in SolarWinds Service Desk. Each record from your Nexset is sent as a separate API request.

  • This endpoint sends data as JSON in the request body. Ensure your Nexset records include the fields required by the SolarWinds Service Desk API for this operation.

The record structure must match the format expected by the SolarWinds Service Desk API. For detailed information about request body formats and available fields, see the SolarWinds Service Desk API Documentation.

Manual configuration

Solarwinds Service Desk destinations can also be manually configured to send data to any valid SolarWinds Service Desk API endpoint. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, data format, endpoint URL, request headers, attribute exclusions, record batching, and response webhooks.

SolarWinds Service Desk APIs expect JSON format for most operations. For update operations, include the ID of the object to be updated at the end of the request URL.

Save & activate

Once all endpoint settings have been configured, click the Done button in the upper right corner of the screen to save and create the destination. To send the data to the configured SolarWinds Service Desk endpoint, open the destination resource menu, and select Activate.

The Nexset data will not be sent to the SolarWinds Service Desk endpoint until the destination is activated. Destinations can be activated immediately or at a later time, providing full control over data movement.