> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withampersand.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SolarWinds Service Desk

## What's supported

### Supported actions

This connector supports:

* [Read Actions](/read-actions), including full historic backfill. Please note that incremental read is supported for `incidents` only. For all other objects, a full read of the SolarwindsServiceDesk instance will be done for each scheduled read.
* [Write Actions](/write-actions).
* [Proxy Actions](/proxy-actions), using the base URL `https://api.samanage.com`.

### Supported Objects

The SolarwindsServiceDesk connector supports writing to and reading from the following objects:

* [incidents](https://apidoc.samanage.com/#tag/Incident/operation/getIncidents)
* [users](https://apidoc.samanage.com/#tag/User/operation/getUsers)
* [roles](https://apidoc.samanage.com/#tag/Role/operation/getRoles)
* [problems](https://apidoc.samanage.com/#tag/Problem/operation/getProblems)
* [changes](https://apidoc.samanage.com/#tag/Change/operation/getChanges)
* [change\_catalogs](https://apidoc.samanage.com/#tag/Change-Catalog/operation/getChangeCatalogs)
* [releases](https://apidoc.samanage.com/#tag/Release/operation/getRelease)
* [solutions](https://apidoc.samanage.com/#tag/Solution/operation/getSolutions)
* [catalog\_items](https://apidoc.samanage.com/#tag/Catalog-Item/operation/getCatalogItems)
* [configuration\_items](https://apidoc.samanage.com/#tag/Configuration-Item/operation/getConfigurationItems)
* [sites](https://apidoc.samanage.com/#tag/Site/operation/getSites)
* [departments](https://apidoc.samanage.com/#tag/Department/operation/getDepartments)
* [groups](https://apidoc.samanage.com/#tag/Group/operation/getGroups)
* [categories](https://apidoc.samanage.com/#tag/Category/operation/getCategories)
* [hardwares](https://apidoc.samanage.com/#tag/Hardware/operation/getHardwares)
* [mobiles](https://apidoc.samanage.com/#tag/Mobile-Device/operation/getMobiles)
* [other\_assets](https://apidoc.samanage.com/#tag/Other-Asset/operation/getAssets)
* [contracts](https://apidoc.samanage.com/#tag/Contract/operation/getContracts)
* [purchase\_orders](https://apidoc.samanage.com/#tag/Purchase-Order/operation/getCPurchaseOrders)
* [vendors](https://apidoc.samanage.com/#tag/Vendor/operation/getVendors)

The SolarwindsServiceDesk connector supports writing only to the following objects:

* [memberships](https://apidoc.samanage.com/#tag/Membership/operation/createMembership)

The SolarwindsServiceDesk connector supports reading only from the following objects:

* [softwares](https://apidoc.samanage.com/#tag/Software/operation/getSoftwares)
* [printers](https://apidoc.samanage.com/#tag/Printer/operation/getPrinters)
* [audits](https://apidoc.samanage.com/#tag/Audit/operation/getAudits)
* [risks](https://apidoc.samanage.com/#tag/Risk/operation/getRisks)

### Example Integration

For an example manifest file of a SolarWinds Service Desk integration, visit our [samples repo on Github](https://github.com/amp-labs/samples/blob/main/solarwindsServiceDesk/amp.yaml).

## Using the connector

This connector uses **API Key authentication**, so you do not need to configure a Provider App before getting started. (Provider Apps are only required for providers using the **OAuth2 Authorization Code grant type**.)

To integrate with SolarWinds Service Desk:

* Create a manifest file similar to the example above.
* Deploy it using the [amp CLI](/cli/overview).
* Embed the [InstallIntegration](/embeddable-ui-components#install-integration) UI component, which will prompt the customer for an API key.
* Start making [Proxy Calls](/proxy-actions), and Ampersand will automatically attach the API key provided by the customer. Please note that this connector's base URL is `https://api.samanage.com`.

## Creating an API key for SolarWinds Service Desk

1. Log in to your [SolarWinds Service Desk account](https://app.samanage.com/login).
2. Navigate to **Setup > Users & Groups > Users** and locate your **User Detail Page** (not your User Profile Card).
3. From the **User detail** page, click **Actions** and select **Generate JSON Web Token** from the dropdown menu. (SWSD administrator rights required.)
4. Under **JSON Web Token**, click **Copy** to save the token for use.

<img src="https://mintcdn.com/ampersand-24eb5c1a/xjDXN-Vr1QbdihBU/images/provider-guides/solarWindsServiceDesk.gif?s=e6d77d46cf9994f26eda558cdad6058a" alt="Generate Token" width="800" height="450" data-path="images/provider-guides/solarWindsServiceDesk.gif" />