Prerequisites for Creating a Connection

A DocuSign integrator key (client ID) and client secret are required to create a DocuSign Adapter connection. A DocuSign integrator key is a unique identifier for each DocuSign integration and is used to authenticate your API calls with DocuSign. To move your integration to DocuSign production, you must be certified and get your integrator key authorized by DocuSign.

Note:

• To create a connection, a trusted public certificate is required. Typically, the certificate is included with Oracle Integration. If you cannot locate the public certificate, contact your administrator. If you download a public certificate, rename the file extension to .crt. To upload the certificate, see Upload a Certificate to Connect with External Services.
• The DocuSign Adapter does not use the connectivity agent to communicate with DocuSign.

1. Log in to your DocuSign developer account at https://appdemo.docusign.com/home.

   1. If you do not have an account, create one here: https://www.docusign.com/developer-center#form-devaccount.
   2. Follow the steps to create and activate the account.
   3. Create a sandbox.
2. Click Settings in the title bar.
3. In the left navigation menu, scroll to INTEGRATIONS, and click Apps and Keys.
4. On the Apps and Keys page, click ADD APP AND INTEGRATION KEY.
5. In the Add Integration Key dialog, enter a name for the app in the App Name field, and click CREATE APP.
6. On your app's page under General Info, note the Integration Key.
7. Click the Copy to clipboard icon to copy the integration key value.
8. In the Authentication section:
   1. Under User Application, select Authorization Code Grant.
   2. Under Secret Keys, click ADD SECRET KEY.
   3. Click the Copy to clipboard icon to copy the secret key value.
   4. Note the secret key value. You’ll require it while configuring the integration key on the Connections page.
9. In the Additional settings section under Redirect URIs, click ADD URI and enter your redirect URI.

   Note:

   If you don't know the following information, check with your administrator:

   • If your instance is new or upgraded from Oracle Integration Generation 2 to Oracle Integration 3.
   • The complete instance URL with the region included (required for new instances).

   For Connections…	Include the Region as Part of the Redirect URL?	Example of Redirect URL to Specify…
   Created on new Oracle Integration 3 instances	Yes.	https://OIC_instance_URL.region.ocp.oraclecloud.com/icsapis/agent/oauth/callback
   Created on instances upgraded from Oracle Integration Generation 2 to Oracle Integration 3	No. This applies to both: New connections created after the upgrade Existing connections that were part of the upgrade	https://OIC_instance_URL.ocp.oraclecloud.com/icsapis/agent/oauth/callback

10. Click Apps and Keys to go back to the Apps and Keys page. The newly created app is displayed under Apps and Integration Keys.
11. Get the API Account ID.

    If you need to log in to multiple accounts for a given login user, get the API account ID.

    1. Under My Account Information on the Apps and Keys page, copy the API Account ID.
    2. Click the Copy to clipboard icon.
    3. Note the value of the API Account ID. You specify this value when configuring the account ID on the Connections page.
12. Get the DocuSign Account ID.
    1. Click the profile image on the upper-right side of the page.
    2. On the menu that displays, note the Account ID that is under the name or organization name. You specify this value before the API Account ID when configuring the account ID on the Connections page.