These docs are for v2.1. Click to read the latest docs for v3.

oAuth Scopes

Understanding scopes for oAuth Apps

Scopes let you specify exactly what type of access you need from users of Signeasy. Scopes limit access for oAuth access tokens. They do not grant any additional permission beyond that which the user already has.

When authorizing a Signeasy oAuth app, requested scopes are displayed to the user on the authorization form.

Available Scopes

user:readUserGrants read access to profile & account information of the user.
files:readFilesGrants read access to all types of files - original, pending, draft and signed.
original:readOriginal DocumentsGrants read access to only the original documents of the user.
original:createOriginal DocumentsGrants access to import new original documents to the user's account.
original:updateOriginal DocumentsGrants access to make changes to the original documents of the user.
signed:readSigned DocumentsGrants read access to all signed documents of the user. This includes documents that are self-signed and signed via the Request Signature feature.
signed:createSigned DocumentsThis scope is required for Embedded Sending, to open an original document to self-sign or send for signature (Request Signature).
signed:updateSigned DocumentsGrants access to actions like rename and delete to the signed documents of the user.
rs:readRequest SignaturesGrants access to all the pending signature requests of the user.
rs:createRequest SignaturesThis scope is required to initiate new signature requests on behalf of the user.
rs:updateRequest SignaturesGrants access to actions like remind and void for all signature requests of the user.
rs:signingurlRequest SignaturesThis scope is required for Embedded Signing, to get the signing links of a document in a signature request.
template:manageTemplatesGrants read, list, rename and delete access to all the templates of the user.
webhooks:manageWebhooksGrants access to read, update and create webhook URLs of the user.

A registered client application can request for any of the scopes mentioned. Grant request page presented to the user will list each of the scopes with the description of the scope being requested by the client application.


A typical permission consent screen

What’s Next

All the API endpoints