> You are reading the Docusign Developer Documentation. For clean Markdown of any page, append .md to the page URL.
>
> Documentation indexes by section:
> - APIs and SDKs: https://docusign.docs.buildwithfern.com/docs/llms.txt
> - Platform 101: https://docusign.docs.buildwithfern.com/platform/llms.txt
> - Extension Apps: https://docusign.docs.buildwithfern.com/extension-apps/llms.txt
> - Docusign CLI: https://docusign.docs.buildwithfern.com/docusign-cli/llms.txt
>
> Authentication (OAuth, JWT Grant, M2M): https://docusign.docs.buildwithfern.com/platform/auth
> Webhooks and Connect: https://docusign.docs.buildwithfern.com/platform/webhooks
>
> OpenAPI specifications: https://docusign.docs.buildwithfern.com/openapi.json
> MCP server: https://docusign.docs.buildwithfern.com/_mcp/server

# Set up your test environment

> Learn how to set up the Agreement Manager API Postman collection and start testing API requests.

This procedure enables you to set up the Agreement Manager API Postman collection and start testing API requests.

## Prerequisites

To use the Postman collection, you need the following:

* Your Docusign developer account credentials
* A [Postman account](https://www.postman.com/postman-account/)

## One-time setup procedures

In addition to the prerequisites, you’ll need to complete these steps:

* [Create an integration in your Docusign developer account](/docs/agreement-manager-api/set-up-test-environment#create-integration-in-docusign-developer-account)
* [Add agreements in Agreement Manager](/docs/agreement-manager-api/set-up-test-environment#add-agreements-in-agreement-manager) (optional)
* [Fork the Postman collection and set environment variables](/docs/agreement-manager-api/set-up-test-environment#fork-the-postman-collection-and-set-environment-variables)

After you've completed the one-time setup, follow the steps in [Authenticate and execute Agreement Manager API requests](/docs/agreement-manager-api/set-up-test-environment#authenticate-and-execute-agreement-manager-api-requests) whenever you want to test Agreement Manager API requests.

### Create integration in Docusign developer account

To authenticate with Docusign so that you can send Agreement Manager API requests, you need to create an integration in your developer account and configure it with the required parameters. This is a one-time setup procedure.

To create the integration:

1. Access the [Apps and Keys](https://admindemo.docusign.com/authenticate?goTo=appsAndKeys) page and supply your Docusign developer account credentials.
2. Select **Add App and Integration Key**.
3. Supply an app name and select **Create App**.
4. Locate the integration key and copy it to a file. You'll need this value later.

   ![Integration key](/_fern-files/_img/3ed144b17c87ab30978e75a6cae5dbfbd6659c73101b8d8dee7e47a7f6ad6b69.webp)
5. In the **Authentication** section, select **Add Secret Key** and then copy the generated value to a file. You'll need this value later.

   ![Secret key](/_fern-files/_img/3754ab73743e66a994e71427eb0d7fb987e4c26f68720df90b2b3133094be56d.webp)
6. In the **Additional Settings** section, select **Add URI** and add this URI:

   **Note:** If you plan to test Agreement Manager API requests with your own app instead of Postman, enter a redirect URI to your app.

   ![Redirect URI](/_fern-files/_img/80d53ef82713c53ddb58d9736448d54607c82660e3e4f87eb029591b259f9c7e.webp)
7. At the bottom of the page, select **Save**.

### Add agreements in Agreement Manager (optional)

In this step, you use the Agreement Manager UI to add sample agreements to your Docusign developer account. Once Agreement Manager has completed AI extraction on the uploaded documents, you'll be able to retrieve the agreement details using Agreement Manager API requests. This is a one-time setup procedure.

Follow the instructions in [Docusign Agreement Manager: Free Trial Sample Agreements](https://support.docusign.com/s/document-item?language=en_US\&bundleId=grn1724866350175\&topicId=amt1724866817262.html) to download Docusign-provided sample agreements and add them to your Docusign developer account.

You can also upload your own sample agreements. You can upload a maximum of 100 agreements to your account.

### Fork the Postman collection and set environment variables

This procedure enables you to fork the Docusign-provided Agreement Manager (previously called Navigator) API collection into your workspace and configure the forked collection with environment variables required for authentication. This is a one-time setup procedure.

To fork the collection and set environment variables:

1. Access the Docusign API: Limited availability APIs Postman workspace via the link that was sent to you when you were accepted to the LA release.
2. Provide your Postman account credentials.
3. Select **Collections** in the Postman left navigation.
4. In the list of collections, select **Navigator API \[version]-beta #examples**.
5. Select the ellipsis to the right of **Navigator API \[version]-beta #examples**, and select **Create a fork**.

   ![Create fork](/_fern-files/_img/8887ea027a1db3a5acba3f0c82f7ee3d8417f4e7871373d5ed4db158819d84cc.webp)
6. Enter a **Fork label** and select your workspace or your team's workspace. Docusign recommends leaving **Watch original collection** selected so that you'll be notified of any updates.

   ![Fork label and workspace](/_fern-files/_img/446bb8f80393f420af0e59b4831b1104dba6f692e98dd759ed9a04ba6f1a24c8.webp)
7. Select **Fork Collection**.
8. In the **Workspaces** menu, select your workspace to switch to it from the Docusign workspace.

   ![Switch workspace](/_fern-files/_img/87bf7ef6f487c25798aeefaa0211cdc39df152efc6d4691671ab1f01d68b0c94.webp)
9. To the right of the workspace name, select **New**, and then select **Environment**.
10. Select the ellipsis next to the new environment, select **Rename**, and then supply a name for the environment.

    ![Rename environment](/_fern-files/_img/ebb82cb8ee510231e548dce88af6c1edfa7081bb67629b5333885926306f0d61.webp)
11. Add these variables with values you obtained when you completed the [Create integration in Docusign developer account](/docs/agreement-manager-api/set-up-test-environment#create-integration-in-docusign-developer-account) procedure.

    | Variable    | Initial and Current Value                                                               |
    | ----------- | --------------------------------------------------------------------------------------- |
    | `clientId`  | The integration key from the integration you created in your Docusign developer account |
    | `clientSec` | The client secret from the integration you created in your Docusign developer account   |

    The list will look similar to this:

    ![Environment variables](/_fern-files/_img/5138bce65a277e5a6b6f5e500a6e0676a2d4d1b17ec09d5846fe521246364df9.webp)
12. Select **Save**.

## Authenticate and execute Agreement Manager API requests

Once you've completed all the [one-time setup](/docs/agreement-manager-api/set-up-test-environment#one-time-setup-procedures) procedures in the previous sections, follow this procedure any time you want to test Agreement Manager API requests.

To authenticate and execute Agreement Manager API requests:

1. Access your Postman workspace.
2. Select **Collections** in the Postman left navigation.
3. In the **Collections** list, select the forked Agreement Manager or Navigator API collection that you created in the previous procedure.
4. In the environment list in the upper right corner, select the environment you created in the previous procedure.

   ![Select environment](/_fern-files/_img/4f0fd7288449ca2df52c5531de47b419316a2b92910a155a00981b5118c5061e.webp)
5. Make sure that the environment name appears selected.
6. Switch to the **Authorization** tab.
7. Scroll to the bottom and select **Get New Access Token**.

   ![Authorization tab](/_fern-files/_img/a97c6a651015e085de80e99a8dcb67c9a94d9756c79f4e3e6ab84fd0c696075a.webp)
8. On the **Log in to Docusign** window, supply your developer account email, click **Next**, supply your password, and click **Next**.

   ![Access token login](/_fern-files/_img/1a3a7e70d88438c6039570eafd895f756d0c396edf929c9019099236d99dbff1.webp)

   **Note:** If the window displays the message **The redirect URI is not registered properly with Docusign**, follow the steps in [Create integration in Docusign developer account](/docs/agreement-manager-api/set-up-test-environment#create-integration-in-docusign-developer-account) to add the required URI to your integration and save it. Then try the authentication steps again.
9. An **Authentication Complete** window appears, followed by a **Manage Access Tokens** window. Select **Use Token**.

   ![Manage access tokens](/_fern-files/_img/fcc8be4b54bd594ba887a0ee1ba74ce6cd6cbf31ae9a76e79eb85eb4816da701.webp)
10. In the **Collections** list, under your forked collection, expand the **Auth** folder.
11. Select the **User Account Info** request.

    ![Get user account info](/_fern-files/_img/56dbe2a8636a748f23ddcd69e589413e10e892bcc2aafc34c71ce91163e4676e.webp)
12. Select **Send**. The request is executed and a post-request script will populate the account ID associated with your default account as the `accountId` environment variable. If you want to use an ID of another account, replace the value of `accountId` with the preferred value.

You can now execute the [Agreements:getAgreement](/docs/agreement-manager-api/reference/agreementmanager/agreements/getagreement) and [Agreements:getAgreementsList](/docs/agreement-manager-api/reference/agreementmanager/agreements/getagreementslist) requests in the **Agreements** folder. They will return the sample agreement data in your account.

![GET requests](/_fern-files/_img/21fd699eae6382bf4a81d23508149841528016406b7135c81cb88db30f18a1a5.webp)

## Submit feedback or request assistance

You can submit feedback about the Agreement Manager API directly in Postman. Docusign is specifically interested in:

* Feedback about how the API does or does not meet the needs of your organization's use cases
* Ideas for features that would make the API more useful to your organization
* Bug reports. Please provide as much detail as possible, including sample requests and responses where appropriate.

You can also submit questions or support requests directly in Postman.

To submit feedback, questions, or support requests:

1. Select the comment icon in the Postman right navigation menu.

   ![Comment icon](/_fern-files/_img/902949d11cd098a58553cca36c54761ab308c0fae1bfdc1dee271cebb7d18040.webp)
2. Enter your feedback and select **Comment**.

   ![Test comment](/_fern-files/_img/4e0274d10f4e0ac30eb021bd8b4ce860590f941e2a9f594752730881d6342cfd.webp)
3. When Docusign responds, you'll receive notification at the email address associated with your Postman account.

## Next steps

* Review [Agreement Manager API use cases](/docs/agreement-manager-api/concepts/use-cases).
* See the [API Reference](/docs/agreement-manager-api/reference) for details about request and response format.