docusign / postman-collections

A easy guide to Getting Started with DocuSign APIs using Postman. Showcases recipes and all REST API endpoints

The DocuSign Postman Collections

This repo contains Postman collections for the DocuSign eSignature API, Rooms API, Click API, and DocuSign Admin API.

Guide: https://developers.docusign.com/tools/postman/

Walkthrough (blog post): https://www.docusign.com/blog/dsdev-please-mr-postman/

Video: https://www.youtube.com/watch?v=mV73U2tg9c0

Follow the guide to install and configure the Postman collection of your choice. You'll find all the API endpoints for the API you've chosen and you can easily and quickly test any API call. Try our most common scenarios, such as embedded signing, sending an envelope via email, applying templates, and more.

What is Postman?

Postman is a collaboration platform for API development and testing. The Postman app is available for Windows, Mac, and Linux.

License

The DocuSign Postman Collections are licensed under the MIT License.

postman-collections's Issues

https://www.docusign.com/products/agreement-cloud

Are instructions still valid?

I'm following the step by step instructions at https://developers.docusign.com/tools/postman/ and everything works exactly as expected until I click Send with my codeFromUrl updated. All I get is "invalid_grant". I also tried the video at https://www.youtube.com/watch?v=mV73U2tg9c0 and the screen I see is slightly different than what I see in the video, however I know I'm creating it for Authorization Code Grant and not JWT. Where can I find troubleshooting assistance for things like this?

Endpoint to update resource xml file does not work

From this collection, I am unable to use the method to update a resource XML file:

{{baseUrl}}/v2.1/accounts/{{accountId}}/brands/{{brandId}}/resources/{{resourceContentType}}
When initially trying to use the endpoint, I get the following error:

{"errorCode":"INVALID_REQUEST_PARAMETER","message":"The request contained at least one invalid parameter. A filename was not found in the Content-Disposition header ('filename=\"filename.ext\""}
The docs do mention the need to include a Content-Disposition header, though upon adding: Content-Disposition: form-data; name="file"; filename="DocuSign_SigningResource.xml", I get the error:

{"errorCode":"BRAND_RESOURCES_XML_LOAD_OR_PARSE_ERROR","message":"XML syntax error. Data at the root level is invalid. Line 1, position 1."}
I have confirmed my XML is valid. I get this same error if I try to include a file that does not exist, so I am not confident the contents of the XML file have anything to do with the error I am receiving.

Authenticate.... Token live ?????

Hi,

my name is Alfonso and we are trying to connect SAP with DocuSign using a REST Service from our system, using yours postman examples to start how the Docusign´s API works

Following the documentation I have achived to obtain a token with post 01 – Authorize Code Grant and I have used Get 04 User Info to obtain the data from my user in DocuSign (perfect) the problem is that after two days I want try it again but the system answer me “internal_server_error”

Could you be the problem of the Token ¿???? I´m not sure if in a video a listen that the token live 8 hours, is it ¿???

I have tried to use the post 03 – Refresh Access Token (when I obtained the token also I obtained the refresh Token)

But the answer is invalid grant

Could be that for obtain a new token and using the post 03 Refresh Access Token after 8 hours it is no valid more ¿???

Now I´m watching the video Get an Access token with JWT Authenticacion (Using this obtaining the token, is it possible needn´t obtain more tokens ¿????? Or I need to refresh the token or anything else .

I don´t want to use the SAP Connector for DocuSign in the SAP BTP, I want to send Envelepes to DocuSign but the problema that I have found is the conecction.

Any help or suggestion ¿???? Thanks in advance. Sorry for my english ¡!!!!

Service Integration Authentication

This repo is for new users. But it is using the legacy header authentication.

Please rework this repo to use service integration authentication with user consent and any other steps new users need to get started with the service integration authentication. And please draft a new blog post.

https://www.docusign.com/blog/dsdev-please-mr-postman/
https://docusign.github.io/postman-esign-api-collection/
https://docs.docusign.com/esign/guide/authentication/oa2_jwt.html

Auth Code Grant Access Token script should store refresh token

For the Authentication > 01 Authorize Code Grant Access Token request, the test script stores the access_token value as an environment variable, but doesn't store the refresh_token value. This means that Authentication > 03 Refresh Access Token doesn't work without manual configuration. This can be fixed by adding a single line of code to the test script for 01.
I'd prefer not to go through forking this to add one line of code, so I'm hoping someone else has the code ready and can easily implement this. The new line of code should be

postman.setEnvironmentVariable("refreshToken", jsonData.refresh_token);