{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":21194,"path":"integrate-applications/integration-hub/docusign-spoke.md","title":"Docusign eSignature Spoke","bundle":null,"doc_type":null,"release":"australia","body":"\n# Docusign eSignature Spoke\n\nAutomate the process of sending a document to an individual or list of recipients for digital signature using Docusign eSignature. For example, automate employee onboarding and offboarding, or send non-disclosure agreements, legal agreements, and statements of work. Use ServiceNow data in document templates and enable users to upload documents for signature as needed.\n\n## Request apps on the Store\n\nVisit the [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) to view all the available apps, and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the [ServiceNow Store version history release notes](https://www.servicenow.com/docs/r/store-release-notes/sn-store-release-notes.html).\n\n## IntegrationHub subscription\n\nThis spoke requires an Integration Hub subscription. For more information, see [Legal schedules - IntegrationHub overview](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf).\n\n## Spoke version\n\nDocusign eSignature spoke v4.5.1 is the latest version. For version history of the spoke, see [Docusign eSignature Spoke release notes](https://www.servicenow.com/docs/r/store-release-notes/store-integrationhub-rn-docusign.html).\n\n## Spoke dependencies\n\nIf you’re having trouble installing the app, ensure that these dependent plugins are installed:\n\n-   ServiceNow IntegrationHub Action Step - REST \\(com.glide.hub.action\\_step.rest\\)\n-   ServiceNow IntegrationHub Runtime \\(com.glide.hub.integration.runtime\\)\n-   ServiceNow Flow Designer - Dynamic Inputs \\(com.glide.hub.dynamic\\_inputs\\)\n\n**Note:** Some of these plugins are licensable features and require an appropriate license if used outside the spoke implementation. For information on licenses, contact your account manager.\n\n## Compatible versions\n\nThis spoke was built for Docusign eSignature API version v2 or v2.1, but may be compatible with later versions.\n\n## Key features\n\nDocusign eSignature spoke enables a flow designer to:\n\n-   Automate the process of sending a document from a ServiceNow attachment or Docusign eSignature template to an individual or recipient list for digital signature.\n-   Discover and synchronize Docusign eSignature accounts and templates in ServiceNow.\n    -   Retrieve a list of accounts and associated templates from Docusign eSignature and then insert or update them as records in the Accounts \\[sn\\_docusign\\_spoke\\_accounts\\] and Templates \\[sn\\_docusign\\_spoke\\_docusign\\_templates\\] tables using the Get Accounts subflow.\n    -   Retrieve templates associated with a specified Docusign eSignature account and then insert or update them as records in the Templates \\[sn\\_docusign\\_spoke\\_docusign\\_templates\\] table using the Get Templates Per Account subflow.\n-   Copy and customize sample flows for sending templates and on-demand document requests.\n-   Pause a flow until a document is signed. A scripted REST API webhook waits for the recipient to sign the document.\n-   Use values from a signed document in a flow.\n-   Attach a completed Docusign eSignature document to a ServiceNow record for auditing purposes.\n-   Manage envelopes and users.\n\n## Spoke requirements\n\n-   Docusign eSignature account\n-   Docusign eSignature administrator credentials\n-   Docusign eSignature application configured to integrate with ServiceNow\n-   Docusign eSignature application details such as client ID, integrator key, secret keys, and RSA keypairs\n-   ServiceNow IntegrationHub subscription\n\n    **Note:** Ensure that you have activated the Flow Designer support for the Service Catalog \\(com.glideapp.servicecatalog.flow\\_designer\\) plugin.\n\n\nSee the [Docusign Developer Center](https://developers.docusign.com/) documentation for instructions on creating and configuring custom applications.\n\n## Spoke flows\n\nThe Docusign eSignature spoke provides sample flows to demonstrate automating Docusign tasks. Use Docusign eSignature spoke actions to automate any tasks desired by your organization. To customize a sample flow, copy it to a new application scope. Available sample flows include:\n\n|Flow|Description|\n|----|-----------|\n|Send a Document for Digital Signature|Sends a document to Docusign for a digital signature when a Service Catalog request is created by the **Send a Document for Digital Signature** item. Before using this flow, activate the **Send a Document for Digital Signature** catalog item.|\n|Send employment offer to candidate using Docusign template|Sends a Docusign envelope to a user using a template. For example, use this flow to send a job offer to a candidate. Before using this flow, activate the **Demonstrate Template - Send Job Offer to Candidate** catalog item.|\n\nThe Docusign eSignature spoke adds catalog items for use with the Docusign eSignature spoke sample flows. Before triggering a Docusign eSignature spoke sample flow, activate these catalog items.\n\n|Catalog item|Description|\n|------------|-----------|\n|Send a Document for Digital Signature|Sends a document for digital signature in Docusign.|\n|Demonstrate Template - Send Job Offer to Candidate|Sends a job offer using a Docusign template.|\n\n## Spoke subflows\n\nThe Docusign eSignature spoke provides sample subflows to demonstrate automating Docusign tasks. To customize a sample subflow, copy it to a new application scope. Available sample subflows include:\n\n|Category|Subflow|Description|\n|--------|-------|-----------|\n|Envelope Management|Attach Docusign Envelope To ServiceNow Record|Attaches all the documents in an envelope to a ServiceNow record.|\n|Get &amp; Set Docusign Field Data|Processes a list of catalog item variables and updates a draft envelope with each variable value.|\n|User Management|Create User|Creates a user including the permission profile and group memberships.|\n|Update User|Updates a user including the permission profile and group memberships.|\n|Templates Management|Get Templates Per Account|Retrieves templates from a Docusign account and stores them in the Templates table.|\n|Default|Docusign Webhook Sample Subflow|Retrieves the recipient details for the specified envelope.|\n|Account Management|Get Accounts|Retrieves Docusign Accounts and Templates related to every account and store them in Accounts and Templates table respectively.|\n\n## Spoke actions\n\nThe Docusign eSignature spoke provides actions to automate Docusign tasks when events occur in ServiceNow. Available actions include:\n\n<table id=\"table_o4g_pc3_lfb\"><thead><tr><th>\n\nCategory\n\n</th><th>\n\nAction\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td rowspan=\"3\">\n\nAccount Management\n\n</td><td>\n\nLook up Account Signature Providers\n\n</td><td>\n\nRetrieves a list of signature providers that the specified account can use.\n\n</td></tr><tr><td>\n\nLook up Accounts by Alias\n\n</td><td>\n\nRetrieves accounts associated with the spoke Connection and Credential alias record.\n\n</td></tr><tr><td>\n\nLook up Role ID\n\n</td><td>\n\nRetrieves the roles ID for the specified role name.\n\n</td></tr><tr><td rowspan=\"12\">\n\nBulk Envelopes Management\n\n</td><td>\n\nCreate Bulk Send List\n\n</td><td>\n\nCreates a bulk send list.\n\n</td></tr><tr><td>\n\nCreate Bulk Send Request\n\n</td><td>\n\nCreates a bulk send request based on an existing bulk send list using an envelope or template.\n\n</td></tr><tr><td>\n\nCreate Bulk Send Test Request\n\n</td><td>\n\nCreates a bulk send test request for testing compatibility with the existing envelope or template.\n\n</td></tr><tr><td>\n\nDelete Bulk Send List\n\n</td><td>\n\nDeletes the specified bulk send list.\n\n</td></tr><tr><td>\n\nLook up Bulk Send Batch Envelopes Stream\n\n</td><td>\n\nRetrieves the envelopes from the specified bulk send batch.\n\n</td></tr><tr><td>\n\nLook up Bulk Send Batch Status\n\n</td><td>\n\nRetrieves the general status of the specified bulk send batch such as number of successes, number pending, number of errors and so on.\n\n</td></tr><tr><td>\n\nLook up Bulk Send Batches Stream\n\n</td><td>\n\nRetrieves the information of the bulk send batches.\n\n</td></tr><tr><td>\n\nLook up Bulk Send List\n\n</td><td>\n\nRetrieves the specified bulk send list.\n\n</td></tr><tr><td>\n\nLook up Bulk Send Lists\n\n</td><td>\n\nRetrieves a list of the bulk send lists.\n\n</td></tr><tr><td>\n\nUpdate Bulk Send Batch Action\n\n</td><td>\n\nPerforms a bulk action \\(resend, correct or void\\) on the specified bulk send batch.\n\n</td></tr><tr><td>\n\nUpdate Bulk Send Batch Status\n\n</td><td>\n\nUpdates the name of the specified bulk send batch.\n\n</td></tr><tr><td>\n\nUpdate Bulk Send List\n\n</td><td>\n\nUpdates the specified bulk send list.\n\n</td></tr><tr><td rowspan=\"2\">\n\nDocument Signature\n\n</td><td>\n\nLook up Embedded Signing URL\n\n</td><td>\n\nCreates a signing URL that is embedded into an application. User can sign the document without leaving the application.**Note:** Signing URL is active for 300 seconds and can be sent to one recipient at a time.\n\n</td></tr><tr><td>\n\nLook up Embedded Signing URL Inline\n\n</td><td>\n\nRetrieves a URL which enables you to embed the recipient view of the on Docusign.\n\n</td></tr><tr><td rowspan=\"6\">\n\nDocument Management\n\n</td><td>\n\nAdd Document to Envelope\n\n</td><td>\n\nAdds documents to envelope.\n\n</td></tr><tr><td>\n\nAttach Combined Document to ServiceNow Record\n\n</td><td>\n\nAttaches Docusign documents to a ServiceNow record.\n\n</td></tr><tr><td>\n\nAttach Docusign Document to ServiceNow Record\n\n</td><td>\n\nRetrieves a signed Docusign document and attaches it to a ServiceNow record.\n\n</td></tr><tr><td>\n\nLook up Document ID by Name\n\n</td><td>\n\nRetrieves the document ID from an envelope using the specified document name.\n\n</td></tr><tr><td>\n\nLook up Documents in an Envelope\n\n</td><td>\n\nReturns a list of documents with an ID and name in the given Docusign envelope.\n\n</td></tr><tr><td>\n\nReplace Document in an Envelope\n\n</td><td>\n\nReplaces documents to envelope.\n\n</td></tr><tr><td rowspan=\"23\">\n\nEnvelope Management\n\n</td><td>\n\nAdd Recipient to Envelope\n\n</td><td>\n\nAdds the specified recipient to the specified envelope.**Note:**\n\n-   Recipient ID used in this action is associated with the envelope and is different from the Recipient ID used in the Get All Template Fields action.\n-   Administrator enters a numeric value for this Recipient ID.\n\n</td></tr><tr><td>\n\nAdd Recipients to Envelope\n\n</td><td>\n\nAdds the specified recipients to the specified envelope.\n\n</td></tr><tr><td>\n\nAttach Docusign Certificate To ServiceNow Record\n\n</td><td>\n\nAttaches a Docusign certificate to a ServiceNow record.\n\n</td></tr><tr><td>\n\nCancel Envelope\n\n</td><td>\n\nCancels an in-process envelope.\n\n</td></tr><tr><td>\n\nCreate Draft Envelope from Template\n\n</td><td>\n\nCreates a draft envelope from an existing Docusign template.\n\n</td></tr><tr><td>\n\nCreate Envelope from Composite Template\n\n</td><td>\n\nCreates an envelope from an existing composite template.\n\n</td></tr><tr><td>\n\nLook up Field ID\n\n</td><td>\n\nRetrieves the ID of the specified field from the specified draft envelope.\n\n</td></tr><tr><td>\n\nLook up Field Value\n\n</td><td>\n\nRetrieves the value of the specified field from the specified envelope.\n\n</td></tr><tr><td>\n\nLook up Fields\n\n</td><td>\n\nRetrieves the list of fields associated to a document in a draft envelope.\n\n</td></tr><tr><td>\n\nLook up Recipient ID by Role Name\n\n</td><td>\n\nRetrieves the recipient ID of the specified role name from the specified envelope.\n\n</td></tr><tr><td>\n\nLook up Recipients in an Envelope\n\n</td><td>\n\nReturns a list of recipients with a Recipient ID and Role Name in the given Docusign envelope.\n\n</td></tr><tr><td>\n\nRemove Recipient from Envelope\n\n</td><td>\n\nDeletes a recipient from a Docusign envelope.\n\n</td></tr><tr><td>\n\nSend Adhoc Signature Request to User\n\n</td><td>\n\nSends a Docusign document associated with the specified ServiceNow record to the specified recipient for signature.\n\n</td></tr><tr><td>\n\nSend Adhoc Signature Request To Users - Inline\n\n</td><td>\n\nSends one or more uploaded documents from a ServiceNow record to multiple recipients.\n\n</td></tr><tr><td>\n\nSend Envelope\n\n</td><td>\n\nSends an envelope to the specified recipients.**Note:** All recipient details must be provided before sending an envelope.\n\n</td></tr><tr><td>\n\nResend Envelop\n\n</td><td>\n\nSend a reminder to recipients who are currently the pending signers.\n\n</td></tr><tr><td>\n\nLock Envelop\n\n</td><td>\n\nLocks the specified envelope and sets the time until the lock expires to prevent other users or recipients from changing the envelope.\n\n</td></tr><tr><td>\n\nUnlock Envelope\n\n</td><td>\n\nUnlocks the specified locked envelope.\n\n</td></tr><tr><td>\n\nSet Field Value\n\n</td><td>\n\nSets the value of the specified field in the specified draft envelope.\n\n</td></tr><tr><td>\n\nSet Field Values\n\n</td><td>\n\nAssigns the values of multiple fields associated to a document in a draft envelope.\n\n</td></tr><tr><td>\n\nWait for Signature from Docusign\n\n</td><td>\n\nPauses a flow until the specified document has been signed or rejected. Returns the status of the document to the flow for further processing.\n\n</td></tr><tr><td>\n\nRemove Recipient from Envelope\n\n</td><td>\n\nDeletes a recipient from an envelope. Prior to using this action, Create Draft Envelope from Template action should be used to generate a draft Envelope.\n\n</td></tr><tr><td>\n\nUpsert Recipients for Envelope\n\n</td><td>\n\nUpdates or adds recipients to the envelope. If a recipient with the specified recipient ID already exists, their information will be updated; otherwise, a new recipient will be created with the provided details. Prior to using this action, Create Draft Envelope from Template action will be used to generate a draft Envelope.\n\n</td></tr><tr><td rowspan=\"3\">\n\nGroup Management\n\n</td><td>\n\nAdd User To Group\n\n</td><td>\n\nAdds user from a group.\n\n</td></tr><tr><td>\n\nLook up Group ID\n\n</td><td>\n\nRetrieves a group ID for the specified role name.\n\n</td></tr><tr><td>\n\nRemove User From Group\n\n</td><td>\n\nRemoves the specified user from a group.\n\n</td></tr><tr><td rowspan=\"3\">\n\nTemplate Management\n\n</td><td>\n\nLook up Templates Per Account\n\n</td><td>\n\nRetrieves the templates associated with the specified Docusign account.\n\n</td></tr><tr><td>\n\nLook up Template Fields\n\n</td><td>\n\nRetrieves all fields in a template that is defined for a recipient.**Note:**\n\n-   Recipient ID used in this action is associated with the template and is different from the Recipient ID used in the Add Recipient to Envelope action.\n-   Value of the Recipient ID is a unique system-generated number.\n\n</td></tr><tr><td>\n\nLook up Template Recipients\n\n</td><td>\n\nRetrieves all recipients defined for a template.\n\n</td></tr><tr><td rowspan=\"4\">\n\nUser Management\n\n</td><td>\n\nCreate User\n\n</td><td>\n\nCreates a Docusign user with the specified user details.\n\n</td></tr><tr><td>\n\nLook up User Detail\n\n</td><td>\n\nRetrieves details for a user.\n\n</td></tr><tr><td>\n\nUpdate User\n\n</td><td>\n\nUpdates the specified user.\n\n</td></tr><tr><td>\n\nDelete User\n\n</td><td>\n\nDeletes the specified Docusign user.\n\n</td></tr></tbody>\n</table>## Available AI agents\n\nInstall Now Assist for Integration Hub and start using the available AI agents. For more information, see [ServiceNow Otto for Integration Hub](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/now-assist-spokes.md).\n\nThis spoke provides standalone AI agents that mimic human-like intelligence to perform tasks in your ServiceNow instance.\n\n-   In the ServiceNow agentic system, you can create an agentic workflow that comprises of a set of large language model \\(LLM\\) instructions along with one or more standalone AI agents to execute an objective. See [Create an agentic workflow](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/intelligent-experiences/configure-use-case-ai-agents.md) for information about adding AI agents to create agentic workflows as per your requirement and provide the required trigger.\n\n    You can also search for other available AI agents and add them to your agentic workflow. See [Find AI agents](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/intelligent-experiences/find-ai-agents.md) for more information.\n\n-   You can create a clone of the required spoke AI agent and customize it as per your requirement. See [Duplicate an AI agent](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/intelligent-experiences/clone-ai-agent.md) for more information about creating a clone.\n-   See [AI Agent Studio \\(legacy\\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/intelligent-experiences/na-ai-agents.md) for information about AI agents.\n\nAvailable AI agents include:\n\n|AI Agent|Description|\n|--------|-----------|\n|Docusign eSignature account management AI agent|Manages account management \\(that is, looks up accounts by alias, retrieves role IDs and identifies account signature providers\\) in Docusign.|\n|Docusign eSignature envelope management AI agent|Manages envelope management \\(that is, sendS signature requests, manages envelope statuses, and attaches DocuSign data to ServiceNow records\\) in Docusign.|\n|Docusign eSignature templates management AI agent|Manages template management \\(that is, retrieves recipient details, accesses template fields, and fetches template names per account\\) in Docusign.|\n|Docusign eSignature bulk envelopes management AI agent|Manages bulk envelope management tasks \\(that is, updates and looks up bulk send batch statuses, manages bulk send lists, create bulk send requests\\) in Docusign.|\n|Docusign eSignature user management AI agent|Manages user management \\(that is, creates, updates, deletes, and retrieves user details\\) in Docusign.|\n|Docusign eSignature group management AI agent|Manages group management \\(that is, looks up group IDs, adds users to groups, and removes users from groups\\) in Docusign.|\n|Docusign eSignature document management AI agent|Manages document management tasks \\(that is, attaches documents, manages envelopes, and retrieves document details\\) in Docusign.|\n|Docusign eSignature document signature AI agent|Manages document signature tasks \\(that is, looks up embedded signing URL, and looks up embedded signing URL inline\\) in Docusign.|\n\nThere might be AI agents installed on your instance that are not used in agentic workflows. To learn how to see all agents that are available to you, see [Find AI agents](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/intelligent-experiences/find-ai-agents.md).\n\n**Note:** Ensure that the user running an AI agent has the required roles and permissions to access data or perform operations on data in the table that is associated with the AI agent.\n\n## Spoke module\n\nThe Docusign eSignature spoke adds a Docusign module to your ServiceNow instance. The Docusign eSignature spoke synchronizes and stores templates and envelopes in ServiceNow. The Docusign eSignature spoke includes these tables and records.\n\n|Table/Record|Description|\n|------------|-----------|\n|Connection Aliases|The Docusign connection alias.|\n|Scheduled Job|The Get Accounts &amp; Templates scheduled job that synchronizes templates and envelopes with your Docusign account.|\n|Accounts|Docusign accounts synchronized with your ServiceNow instance. To synchronize accounts, see [Synchronize Docusign with ServiceNow](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/sync-docusign-servicenow.md). The Get Accounts subflow retrieves a list of accounts and associated templates from Docusign and then inserts or updates them as records in the Accounts \\[sn\\_docusign\\_spoke\\_accounts\\] and Templates \\[sn\\_docusign\\_spoke\\_docusign\\_templates\\] tables.|\n|Templates|Docusign templates from synchronized Docusign accounts. The Get Templates Per Account subflow retrieves templates associated with a specified Docusign account and then inserts or updates them as records in the Templates \\[sn\\_docusign\\_spoke\\_docusign\\_templates\\] table.|\n|Envelopes|Docusign envelopes from synchronized Docusign accounts. Records in the Envelopes table are updated only when webhook is configured for the Docusign account.|\n|DocuSign Webhook Answer Subflows|List of webhook answer subflows.|\n\nThe Docusign eSignature spoke tables include these fields.\n\n<table id=\"table_gbz_nyc_ygb\"><thead><tr><th>\n\nTable\n\n</th><th>\n\nFields\n\n</th></tr></thead><tbody><tr><td>\n\nAccounts \\[sn\\_docusign\\_spoke\\_accounts\\]\n\n</td><td>\n\n-   Account ID\n-   Account Name\n-   Description\n-   Email\n-   Alias\n-   Display Name\n\n</td></tr><tr><td>\n\nTemplates \\[sn\\_docusign\\_spoke\\_docusign\\_templates\\]\n\n</td><td>\n\n-   Account\n-   Template ID\n-   Name\n-   Description\n-   Last Modified\n-   Display Name\n\n</td></tr><tr><td>\n\nEnvelopes \\[sn\\_docusign\\_spoke\\_envelopes\\]\n\n</td><td>\n\n-   Account\n-   ID\n-   Status\n-   Signed Date\n-   Declined Reason\n-   Display name\n-   Embedded Signing\n-   Signed Date Time Zone\n-   Template\n\n</td></tr></tbody>\n</table>## Spoke triggers\n\nServiceNow supports specific events on Docusign that create triggers. You must first configure a flow with a supported trigger definition. When an event, for example, a push request, occurs on the Docusign, it sends the payload via a webhook to the ServiceNow instance. After that, the flow that you configured is triggered at the ServiceNow instance to automate a workflow. The supported events are:\n\n|Category|Trigger|Definition|\n|--------|-------|----------|\n|Envelope Management|Envelope Completed|Trigger is initiated when an envelope has been completed by all the recipients. Configure the flow to execute only when the specified trigger conditions are met.|\n|Envelope Declined|Trigger is initiated when an envelope has been declined by one of the recipients. Configure the flow to execute only when the specified trigger conditions are met.|\n|Envelope Deleted|Trigger is initiated when a sent envelope is deleted. Configure the flow to execute only when the specified trigger conditions are met.|\n|Envelope Delivered|Trigger is initiated when all recipients have opened the envelope through the Docusign signing website. Configure the flow to execute only when the specified trigger conditions are met.|\n|Envelope Sent|Trigger is initiated when an envelope is sent to recipient. Configure the flow to execute only when the specified trigger conditions are met.|\n|Envelope Voided|Trigger is initiated when an envelope has been voided by the sender or has expired. Configure the flow to execute only when the specified trigger conditions are met.|\n|Recipient Management|Recipient Completed|Trigger is initiated when the recipient has completed their actions for the envelope. Configure the flow to execute only when the specified trigger conditions are met.|\n|Recipient Declined|Trigger is initiated when the recipient declines to sign the document\\(s\\) in the envelope. Configure the flow to execute only when the specified trigger conditions are met.|\n|Recipient Delivered|Trigger is initiated when the recipient has viewed the document\\(s\\) in an envelope through the Docusign signing web site. Configure the flow to execute only when the specified trigger conditions are met.|\n|Recipient Sent|Trigger is initiated when an email notification is sent to the recipient signifying that it is their turn to sign an envelope. Configure the flow to execute only when the specified trigger conditions are met.|\n\nFor information about setting up the triggers for the Docusign eSignature spoke, see [Set up triggers for the Docusign eSignature spoke](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/setup-ext-triggers-docusign.md). For more information about inbound integration, see [Conditional and event-driven inbound integration](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/conditional-and-event-driven-inbound-integration.md).\n\n## Docusign account requirements\n\nThe Docusign eSignature spoke requires configuring your Docusign account to generate an OAuth 2.0 JWT Bearer Grant token.\n\n## Connection and credential alias requirements\n\nIntegration Hub uses aliases to manage connection and credential information, and OAuth credentials. Using an alias eliminates the need to configure multiple credentials and connection information profiles when using multiple environments. If the connection or credential information changes, you don't need to update any actions that use the connection.\n\nThis spoke uses the Docusign Connection &amp; Credential Alias record to authorize actions.\n\n**Important:**\n\n-   You can choose to set up the Docusign spoke using [authorization code grant](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/setup-docusign-authorization-code.md) or [JWT grant](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/setup-docusign-jwt.md).\n\n    -   Use Authorization Code Grant if your integration uses a browser or client to make requests to a web server.\n    -   Use JWT Grant if each user of your integration will use a single system account to log in.\n    For more information about when to chose either of the setup methods, see [Choose OAuth Type](https://developers.docusign.com/platform/auth/choose/) in [Docusign Developer documentation](https://developers.docusign.com/).\n\n-   Your company may have a Docusign account for each department that uses Docusign. To use multiple accounts with this spoke, create a child alias for each account. Also, ensure that you override the base alias with the child alias in your flows. At runtime, the system identifies the child alias associated with the account and sends the correct connection and credential information in the request.\n\n    -   For more information about child alias and overriding the base alias, see [Supporting multiple connections](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/support-multiple-connections.md).\n    -   For information about setting up multiple accounts, see [Create child aliases for additional Docusign accounts](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/create-aliases-docusign.md).\n    If your company only has one account, you can use the default **Docusign** alias provided with the spoke and proceed to setting up the Docusign spoke using [authorization code grant](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/setup-docusign-authorization-code.md) or [JWT grant](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/setup-docusign-jwt.md).\n\n\n## MID Server requirements\n\nThese actions use REST calls that can run either on an instance or, optionally, through a MID Server. Use the connection record associated with the Docusign alias to configure where actions run and, if needed, specify MID Server selection attributes. For more information, see [MID server](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/servicenow-platform/mid-server-landing.md).\n\nTo set up the MID Server for this spoke, see [Set up MID Server for a spoke](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/config-adv-mid-settings-for-oauth-on-mid.md).\n\n"}}