The Official DocuSign Ruby Client

RubyGems version RubyGems downloads Build status



  • Ruby 1.9+


This open-source SDK is provided for cases where you would like to make additional changes that the SDK does not provide out-of-the-box. If you simply want to use the SDK with any of the examples shown in the Developer Center, follow the installation instructions below.


Install via your application's Gemfile:

  1. In your application's Gemfile, add:
    gem 'docusign_esign'
  2. Open your preferred console.
  3. In your project directory, execute the installer by typing:
    bundle install

Manual install:

  1. Open your preferred console.
  2. In the console, type:
    gem install docusign_esign


This client has the following external dependencies:

  • Jwt>=1.5.2
  • Json>=2.1.0
  • Typhoeus>=1.0.1

Code Examples


DocuSign provides a sample application code referred to as a Launcher. The Launcher contains a set of 31 common use cases and associated source files. These examples use either DocuSign's Authorization Code Grant or JSON Web Tokens (JWT) flows.

Proof-of-concept applications

If your goal is to create a proof-of-concept application, DocuSign provides a set of Quick Start examples. The Quick Start examples are meant to be used with DocuSign's OAuth Token Generator, which will allow you to generate tokens for the Demo/Sandbox environment only. These tokens last for eight hours and will enable you to build your proof-of-concept application without the need to fully implement an OAuth solution.

OAuth Implementations

For details regarding which type of OAuth grant will work best for your DocuSign integration, see the REST API Authentication Overview guide located on the DocuSign Developer Center.

For security purposes, DocuSign recommends using the Authorization Code Grant flow.


Log issues against this client through GitHub. We also have an active developer community on Stack Overflow.


The DocuSign Ruby Client is licensed under the MIT License.

Additional Resources