Desarrolladores
Explorar HelloSign API con Postman
by
Taylor Krusen
April 6, 2021
3
minute read
RSS icon
Nuevo aspecto, ¡el mismo gran producto! HelloSign ahora es Dropbox Sign.

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.

Image showing the location in Postman to find more information about the HelloSign API

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).  
Image showing where to find your API key in the HelloSign app.

Image showing the "Variables" tab in Postman

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

Let’s use Postman to call Send Signature Request, manually complete the signature, inspect the request status with Get Signature Request,  and call Get Files to download the signed file.

Image showing the "signature_request" object in Postman, with the "signature_request_id" item highlighted.

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.

Image showing the API success message from HelloSign

Image showing the "signature_request" response object in Postman, with the "is_complete", "is_declined" and "has_error" flags highlighted

Image showing the successfully signed document in HelloSign's web interface

Explorar HelloSign API con 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!

Logo de intercambio social de FacebookLogo de intercambio social de TwitterLogo de intercambio social de LinkedInRSS icon
Up next: