# DocuSign authentication

> Depending on the authentication type you select, you need one of the following credentials:

Depending on the authentication type you select, you need one of the following credentials:

* OAuth 2.0 Authorization code: Account ID, the email and password associated with your DocuSign account.
* Bring your own OAuth 2.0 app: Client ID, Client secret, Account ID, Environment.

To learn how to create your own OAuth 2.0 application, refer to the DocuSign [documentation](https://developers.docusign.com/platform/webhooks/connect/validation-and-security/oauth-connect/).

:::note
When registering your OAuth application in DocuSign, make sure to set the [callback URL](connections#callback-url) to the value displayed on the connection creation page, for example `https://cloud.uipath.com/provisioning_/callback` for Automation Cloud.
:::

:::note
Only DocuSign **production** accounts can be used for logging in with the DocuSign connector. DocuSign **demo** or **developer** accounts cannot be used.
:::

## Retrieve your credentials

When establishing a connection using the DocuSign connector, you can first input an Account ID. This step is optional, and
you can simply select **Connect** to move to the next step.

:::note
If the **Account ID** field is left empty, the default Account ID associated with the authenticated user’s DocuSign account automatically used
for all the DocuSign activities. On the top-right hand corner of your DocuSign application’s home page, select the user icon
and you can view the default account number (not to be mistaken for Account ID) and default account name.
:::

To find your default DocuSign Account ID:

1. Log in to your DocuSign account.
2. Select the **Settings** tab on the top of the screen.
3. On the left panel, under **Integrations**, select **Apps and Keys**.
4. The **API Account ID** displayed here is your default Account ID.

## Add the DocuSign connection

To create a connection to your DocuSign instance, you need to perform the following steps:

1. Select Orchestrator from the product launcher.
2. Select a folder, and then navigate to the **Connections** tab.
3. Select **Add connection**.
4. To open the connection creation page, select the connector from the list. You can use the search bar to find the connector.
5. You can choose between two authentication types: OAuth 2.0 Authorization code or Bring your own OAuth 2.0 app.
6. Enter the required credentials and select **Connect**.

   For any secret-type field, you can select the menu next to the field and choose **Use credential asset** to reference an Orchestrator credential asset linked to an external vault instead of entering the value directly. For more information, see [Use credential assets for connections](credential-store-connections.md).
7. Your connection has been added.

## Permissions

The default permissions enabled in the DocuSign account you connect with are also used in the connector. Please visit [DocuSign Support Center](https://support.docusign.com/s/document-item?language=en_US&rsc_301&bundleId=pik1583277475390&topicId=pof1583277362435.html&_LANG=enus) for the available permissions, or contact your administrator.
