Skip to navigation

Authentication

View as Markdown

All calls to the Docusign Workspaces API are authenticated using an access token that your app obtains using one of the standard OAuth 2.0 grants supported by Docusign:

Note: See Choose an OAuth type for details on when to use each authentication type.

The only difference between authenticating with the Workspaces API and the eSignature API is that, when requesting the access token in your OAuth2 scenario, you must request a special scope in addition to your other Docusign eSignature Authentication scopes.

ScopeDescription
dtr.company.readUsed to read workspace profile information.
dtr.rooms.readUsed to read workspace data.
dtr.rooms.writeRequired for operations to update workspace data.
dtr.documents.writeRequired for operations to modify workspace documents.
signatureUsed for operations on the Docusign eSignature API.

Important: If the required Workspaces API scope was not explicitly requested, calls to the Workspaces API will fail.

Next steps

Learn how to get an access token with any authentication flow by viewing these guides: