You’ll need Postman in order to follow along. You can use either the Postman web client or the Postman desktop agent (supports Mac, Linux, and Windows). The images in this article are from the Postman desktop agent for Mac.
Import the Postman Collection
If you’re using the Postman web client, then you can skip this step and jump right to building in the HelloSign Public Workspace.
For folks using the desktop agent, you can import the HelloSign API collection into your Postman instance by using this button:
Alternatively, you can import the collection by clicking the “Run in Postman” button in the collection documentation page. Similar to the HelloSign API, the Postman collection is organized into a series of Objects and Methods. Each object has various methods that can be used to interact with that object through the API.
Note that each respective endpoint in the HelloSign API collection has documentation (click the dropdown arrow) that includes links to that endpoint’s API reference documentation.
Set the Collection Variables
Postman supports user-defined variables with different scopes. The HelloSign API collection makes use of collection variables. Once you enter your authorization information into the collection variables, you’ll be authorized to call each endpoint in the collection (according to the permissions on your HelloSign account).
- When logged into HelloSign, grab your API Key, and optionally your Client ID, from your API page (located under Integrations —> API).
Note: API calls sent in test mode are not legally binding and don’t count towards your plan.
With your HelloSign credentials entered as collection variables, you’re ready to start making API calls!
Use Postman to Call the HelloSign API
Go to the inbox of the email you just provided. You should receive a signature request from HelloSign. Click the link in the email and fully complete the signing flow before proceeding to the next step.
Exploring the HelloSign API using Postman
Thanks for following along! You can use the HelloSign API Postman collection on HelloSign’s Public Workspace, or import it here:
We’re big fans of Postman and use this collection internally. When you’re ready to add the HelloSign API to your codebase, the Quick Start Guide is a great next step!