Documentation forService Desk

Setup: Labs - Built-in integration for Docusign

Introduction

Through the Labs module, you can set up a built-in integration with EntraID. If you have never used a feature in Labs before, read Setup: Labs to gain an understanding of how Labs works in Service Desk.

Navigation

ITSM customers ESM customers
Setup > Setup > Labs

Organization > Setup > Labs

Built-in process integrations

For Advanced and Premier customers.

Built-in process integrations are pre-configured connectors for popular third-party tools that are ready to use without any API knowledge. Instead of manually constructing HTTP requests and API payloads, you simply select the actions you want to perform on the target product and use the Field Mapping section to connect your Service Desk fields to the corresponding fields in the integrated product. Once configured, the integration is available as a step in your service catalog items, change catalog items, and runbooks, so your team can automate cross-product workflows in minutes.

Set up integration

  1. Hover over the row for the built-in integration.

  2. Click the ellipsis on the far right of the row, and select Edit.

    The Edit Http Integration pane opens on the right.

  3. In the Edit pane, select your Authentication method and link to the credentials you created. See Step 1: Establish a new credential set.

  4. Under Actions, select the actions you want to allow. Available actions differ for each built-in integration.

    • Send Template for Signature. Send a pre-defined DocuSign template to one or more recipients.

    • Create Envelope from Document. Upload a file from a Service Desk ticket and send it for signature.

    • Check Envelope Status. Retrieve the current status (Sent, Delivered, Completed, Declined).

    • Void Envelope. Cancel an active signature request.

    • Add Signer to Active Envelope. Dynamically add a recipient to an existing workflow.

  5. For each action, map the product's fields to your Service Desk fields. When you create field mappings, Service Desk automatically displays the mandatory fields, marked with a red asterisk. You can then define additional mapping for other fields by using add/remove custom fields.

    Be sure that every mandatory field is mapped to a Service Desk field. Any information you want to send to the integrated product must be mapped so Service Desk knows what to send. If any Service Desk field shows as Not Set, you cannot save.
  6. Optionally, you can enable Output Variable Abstraction for Built-in Process Integrations. This feature enables extraction of output variables from API responses in built-in process integrations. Once enabled, output variable mappings can be configured on built-in process integrations such as DocuSign, Microsoft Entra ID, and Slack, allowing you to capture response values. You can choose to enable for all users or specific users. API product fields to Service Desk fields are indicated by a right-facing arrow during the mapping process.

  7. Click Save.

  8. To take advantage of an integration, return to Process integrations and follow the instructions at Step 3: Add process integration to a workflow in a Service Catalog, Change Catalog, or Runbook.

Related topics

Setup: Labs