{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":21497,"path":"integrate-applications/integration-hub/setup-ext-triggers-docusign.md","title":"Set up triggers for the Docusign eSignature spoke","bundle":null,"doc_type":null,"release":"australia","body":"\n# Set up triggers for the Docusign eSignature spoke\n\nSet up the trigger to generate the callback URL on your ServiceNow instance.\n\n## Before you begin\n\n-   Request an Integration Hub subscription.\n-   Activate and set up the Docusign eSignature spoke.\n-   Role required: admin.\n\n## Enable system property for client credentials grant type\n\nCreate or enable the glide.oauth.inbound.client.credential.grant\\_type.enabled system property to use the OAuth client credentials grant type for inbound integrations from the Docusign OAuth client to ServiceNow instance.\n\n### Before you begin\n\nRole required: admin\n\n### About this task\n\nFor more information about client credentials grant type, see [Client Credentials](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-security/client-credentials.md).\n\n### Procedure\n\n1.  Navigate to **All** &gt; **System Properties** &gt; **All Properties**.\n\n2.  Search for the `glide.oauth.inbound.client.credential.grant_type.enabled` system property.\n\n3.  Open the record.\n\n4.  For **Value**, enter `true`.\n\n5.  Right-click the form header and click **Save**.\n\n\n## Create an application registry to authenticate the inbound calls\n\nCreate an application registry in the ServiceNow instance to authenticate the inbound calls.\n\n### Before you begin\n\nRole required: admin\n\n### Procedure\n\n1.  Navigate to **All** &gt; **System OAuth** &gt; **Application Registry**.\n\n2.  Click **New**.\n\n3.  Select **Create an OAuth API endpoint for external clients**.\n\n4.  On the form, fill in the fields.\n\n<table id=\"table_jyr_bfl_b2c\"><thead><tr><th>\n\nField\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nName\n\n</td><td>\n\nName to identify the application registry record. For example, `Docusign External Trigger`.\n\n</td></tr><tr><td>\n\nOAuth Application User\n\n</td><td>\n\nUser role to which the OAuth token flow is mapped.**Important:** By default, this field is not displayed on the Application Registries form. Configure the form layout to see the field on the form. For information about configuring the form layout, see [Configuring the form layout](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-administration/configure-form-layout.md).\n\n</td></tr></tbody>\n</table>5.  Right-click the form header and click **Save**.\n\n    Application registry record is created and value of **Client Secret** is generated.\n\n    Copy and record the values of **Client ID** and **Client Secret** for later use.\n\n\n## Activate the trigger definition on ServiceNow instance\n\nActivate the trigger definition to generate the callback URL on your ServiceNow instance.\n\n### Before you begin\n\nRole required: flow\\_designer and connection\\_admin.\n\n### About this task\n\nDocusign uses the callback URL to securely send the payload to the ServiceNow instance.\n\n### Procedure\n\n1.  Navigate to **All** &gt; **Process Automation** &gt; **Workflow Studio**.\n\n2.  Select the **Integrations** tab.\n\n3.  Toggle and enable the **Inbound** tab.\n\n4.  Locate the **Docusign eSignature Spoke** card and select **View Details**.\n\n    \\[Omitted image \"inbound-docusign.png\"\\] Alt text: Locate the Docusign eSignature Spoke card.\n\n5.  Select **Configure**.\n\n    \\[Omitted image \"comf-ext-trigger-docusign.png\"\\] Alt text: Configure the endpoint.\n\n6.  On the form, fill these values.\n\n    |Field|Description|\n    |-----|-----------|\n    |Required roles|Roles using which the flow will be triggered. For example, select **admin**.|\n    |Application Registry|Select the application registry you had created to authenticate inbound calls. For example, select **Docusign External Trigger**.|\n\n    \\[Omitted image \"conf-endpt-docusign.png\"\\] Alt text: Activate the endpoint.\n\n7.  Click **Activate**.\n\n    The endpoint is activated and the value of **URL** is generated.\n\n    Copy and record the value of **URL** for later use.\n\n    \\[Omitted image \"copy-url-docusign.png\"\\] Alt text: Copy the URL for later use.\n\n\n## Add configuration in Docusign account\n\nAdd a custom configuration in the Docusign account to send real‐time data updates to the ServiceNow instance.\n\n### Before you begin\n\nRole required: admin\n\n### Procedure\n\n1.  Log in to the Docusign account as an admin.\n\n2.  Click **Admin**.\n\n3.  Navigate to **Integrations** &gt; **Connect**.\n\n4.  Under **Configurations**, click **Add Configuration** and select **Custom**.\n\n5.  On the form, fill in the values.\n\n<table id=\"table_oy2_j4l_b2c\"><thead><tr><th>\n\nField\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nName\n\n</td><td>\n\nName to identify the custom configuration record.\n\n</td></tr><tr><td>\n\nURL to Publish\n\n</td><td>\n\nEnter the URL that is generated when you activated the trigger definition in this format: `https://<ServiceNow-instance-name>.service-now.com/api/sn_docusign_spoke/docusign_esignature_external_trigger`.For more information, [Activate the trigger definition on ServiceNow instance](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/setup-ext-triggers-docusign.md).\n\n</td></tr><tr><td>\n\nData Format\n\n</td><td>\n\nEnsure that you select **REST v2.1**.\n\n</td></tr><tr><td>\n\nEvent Message Delivery Mode\n\n</td><td>\n\nSelect **Send Individual Messages \\(SIM\\)**.\n\n</td></tr><tr><td>\n\nTrigger Events\n\n</td><td>\n\nExpand **Envelope and Recipients** and select these events:-   Envelope Sent\n-   Envelope Delivered\n-   Envelope Signed/Completed\n-   Envelope Declined\n-   Envelope Voided\n-   Envelope Deleted\n-   Recipient Sent\n-   Recipient Auto Responded\n-   Recipient Delivered\n-   Recipient Signed/Completed\n-   Recipient Declined\n\\[Omitted image \"trigger-events-docusign.png\"\\] Alt text: Triggers events to be selected.\n\nUnder **Include Data**, select the **Recipients** option. Select other options as per your requirement.\n\n\\[Omitted image \"include-data.png\"\\] Alt text: Select the Recipients option.\n\n</td></tr></tbody>\n</table>6.  Under **Integration and Security Settings**, select the **Include OAuth \\(Recommended\\)** check box.\n\n7.  Click **Add Configuration**.\n\n    The custom configuration record is created.\n\n8.  Click **Actions** for the custom configuration record that you created and select **Edit**.\n\n    \\[Omitted image \"edit-conf-docusign.png\"\\] Alt text: Edit the custom configuration.\n\n9.  Under **Integration and Security Settings**, click **Manage OAuth**.\n\n    The **OAuth 2.0** tab is displayed.\n\n10. Enter the values of Client ID and Client Secret.\n\n    These values are created when you create application registry record in ServiceNow instance. For more information, see [Create an application registry to authenticate the inbound calls](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/setup-ext-triggers-docusign.md).\n\n11. Enter **Authorization Server URL** in this format: `https://<ServiceNow-instance-name>.service-now.com/oauth_token.do`.\n\n12. Click **Save**.\n\n\n### What to do next\n\nCreate flows in Workflow Studio using these triggers as per your requirement. For more information, see .\n\n"}}