E-signature With HelloSign and Spring boot

1. What is HelloSign?

HelloSign allows you to electronically request and add legally binding signatures to any document, from new hire agreements to loans to NDAs. HelloSign is available in an intuitive web interface, a developer-friendly API, or as a Salesforce add-on.

2. Create an account at :

Then log in to your account :

3. Create Spring boot application :


Dependencies: Spring Web, and Spring Boot DevTools.

After downloading and unzipping, the project adds this dependency:


See pom.xml below :

4. Let’s get the API key :

Go settings :

Then API :

Create your API key.

5. Prepare the template :

I prepared a simple pdf file, download it from here

Click template and then create a template

Upload the file and click next :

Add the role Client :

then click next :

Now lest’s add the signature element and the name to our template :

Then click next.

Add the template title and click Save template

Now we finished creating the template, let’s start coding.

6. Create a Service :

let’s create a package named service inside it create HelloSignService class :

7.Create a rest controller :

I create a webhook method that receives events when helloShign sends the document to the client and when the client signs the document.

We need to use ngrok to create a redirect URL for the webhook.

8. Download ngrok :

Just download it from https://ngrok.com/download and unzip the compressed file.

After that open a terminal in the directory where you unzipped ngrok.

For Linux :

./ngrok http 8080

For Windows :

ngrok http 8080

9. Add Account callback :

Navigate to the API tab as we did it for creating an API key, but now add the ngrok forwarded URL :

For example, my URL looks like this :


you can change https://6edf20251401.ngrok.io by your domain if you have or anything but keep in mind the callback URL should have /hellosign/webhook part.

10. Let’s test what we did :

Inside postman :

POST: http://localhost:8080/api/sign

You will receive an email from helloSign :

11. Last word :

You can find the source code from my GitHub Repository:

If you enjoyed this article, please clap it up 👏 and share it so that others can find it! Follow me to get more of me 😄.

I'm Hamdi, a software engineer 👨‍💻, and writer 📝

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store