Postman. Getting Started With The DNA API

This article provides a pre-configured Postman collection and environment to help you quickly test and integrate with the DNA Behavior API.

Using Postman is optional, but strongly recommended during development and initial validation before moving integrations into production code.

What This Includes

The DNA Behavior Postman setup includes:

• A ready-to-use Postman Collection with common API requests

• A Postman Environment file for managing variables such as account IDs and subscription keys

This allows you to:

• Validate authentication

• Test API responses

• Understand request and response structures

• Debug issues before implementation

Prerequisites

Before using Postman, ensure you have:

• Approved access to the DNA Developer Portal

• Your Subscription Key (Primary or Secondary)

• A Postman account installed locally or accessible via the web

Download the Postman Files

Download both files below and import them into Postman:

• Postman Collection

• Postman Environment

Both files are required for the requests to function correctly.

How to Set Up in Postman

1. Open Postman

2. Import the Collection file

3. Import the Environment file

4. Select the imported environment from the environment dropdown

5. Update the required environment variables:

   • subscriptionKey

   • accountId

   • Any other placeholders marked in the environment

Once configured, you can begin sending requests immediately.

Learn How to Use the Collection

We recommend watching the on-demand webinar that walks through:

• Environment setup

• Authentication

• Running example requests

• Common troubleshooting scenarios

This ensures you get the most value from the collection and avoid common mistakes.

Notes and Best Practices

• Never commit your subscription key to version control

• Use the Secondary Key for testing where possible

• Rotate keys periodically for security

• Treat Postman as a development and validation tool only

Need Help?

If you experience issues setting up Postman or accessing the API:

• Confirm your Developer Portal access

• Verify your subscription key is active

• Contact DNA Behavior Support if needed

Submit a ticket here