---
title: "Set up Connect OAuth for the specified account."
method: POST
path: "/v2.1/accounts/{accountId}/connect/oauth"
tags: ["ConnectConfigurations"]
---

# Set up Connect OAuth for the specified account.

`POST /v2.1/accounts/{accountId}/connect/oauth`

Sets up Connect OAuth for the specified account using an authorization server of your choice. To use this endpoint, get the client ID and client secret from your authorization server.

When you call this endpoint, Docusign requests an access token from your authorization server. Docusign will use that token in the Authorization HTTP header of your account's Connect messages. Finally, your listener will be responsible for validating the token by calling the authorization server.

<ds-inlinemessage>
To use this method, you must be an account administrator
and Connect must be enabled on your account.
</ds-inlinemessage>


## Related topics:
- [OAuth for Docusign Connect](/platform/webhooks/connect/validation-and-security/oauth-connect/)

## Path parameters

- `accountId` string, required

## Request body

- ConnectOAuthConfig — A complex object describing a Connect OAuth configuration.
  - `authorizationServerUrl` string — The token URL for your authorization server or OAuth service. This property is required.
  - `clientId` string — The client ID assigned to your app by your authorization server or OAuth service. This property is required.
  - `clientSecret` string — The secret value provided by your authorization server. This property is required.
  - `customParameters` object
  - `scope` string — The scopes that your app will request from the authorization server. This property is optional. **Note:** If you are using Azure, this value is the application ID URI of the secified resource affixed with the `.default`. For example: `api://{{clientId}}/.default`

## Response `201`

Successful response.

## Other responses

- `400` — Error encountered.

---

[API](https://skmtc.net/docusign/apis/docusign-esignature-rest-api.md) · [All operations](https://skmtc.net/docusign/apis/docusign-esignature-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/docusign/docusign-esignature-rest-api/versions/77f1998c313d/schema)