API version:

Requests an OAuth2.0 authorization code grant type.

The user will first be prompted to login to RightSignature to validate their identity and will be prompted to authorize or deny access to their account. RightSignature will redirect the user-agent to the configured redirect_uri along with an authorization_code parameter after access has been authorized. This code can than be exchanged for an access token.

Supported Formats

json

Errors

Code Description Metadata
403 Forbidden
- OAuth2 Error

Examples

REQUEST:
https://api.rightsignature.com/oauth/authorize?client_id=CLIENT_ID&redirect_uri=REDIRECT_URI&response_type=code

USER-AGENT REDIRECT:
https://your_redirect_uri?code=AUTHORIZATION_CODE

Params

Param name Description
client_id
required

The API Key's Client ID

Validations:

  • Must be a String

redirect_uri
required

Where the user-agent will be redirected to after an authorization code is granted. Note that this MUST match what is on record with the API Key associated with the passed in client id

Validations:

  • Must be a String

response_type
required

Requests the authorization code grant

Validations:

  • Must be one of: code.

scope
optional

Level of access that the application is requesting.

Validations:

  • Must be one of: read, write, read write.