Skip to content
Postman API Testing Tips

How To Use Environment Variables In Postman Request Body

API Testing Blog

How to use Environment Variables in Postman Request Body

Environment variables are powerful tools in Postman that allow you to manage dynamic data, including API credentials, URLs, and other sensitive information, without hardcoding them directly into your requests. This guide will show you how to leverage environment variables for a more flexible and secure API testing process.

Define Environment Variables

  1. Navigate to the Environments Tab: In Postman, click on the “Environments” tab located in the left sidebar.
  2. Create a New Environment: Click on the “Add” button to create a new environment. You can give it a meaningful name, such as “staging” or “production.”
  3. Add Variables: Click on the “Add” button within your new environment to define variables. Each variable requires a name (e.g., BASE_URL) and a value (e.g., https://api.example.com).

Access Environment Variables in Request Body

Postman uses the syntax {{variable_name}} for inserting environment variables into requests. Here’s how to use them in the request body:

1. JSON Request Body

{
    "name": "John Doe",
    "email": "{{email}}",
    "password": "{{password}}"
}

2. Form-data Request Body

key=value&email={{email}}&password={{password}}

3. x-www-form-urlencoded Request Body

email={{email}}&password={{password}}

Example: Sending an API Request with Variable Data

Let’s say you have an API endpoint that requires a base URL, a username, and a password. You can set up these values as environment variables:

Environment Variables

  • BASE_URL: https://api.example.com
  • username: testuser
  • password: testpass

Postman Request

POST {{BASE_URL}}/users


Body:
{
    "username": "{{username}}",
    "password": "{{password}}"
}

When sending this request, Postman will dynamically replace {{BASE_URL}}, {{username}}, and {{password}} with their respective environment values.

Using Environment Variables in Tests

Environment variables are also useful for building more dynamic and robust API tests:

pm.test("Username should be correct", function () {
    pm.expect(pm.response.json().username).to.be.equal("{{username}}");
});

This test verifies that the username returned in the response matches the value stored in the username environment variable.

Best Practices for Environment Variables

  • Keep Sensitive Data Secure: Never store sensitive information like API keys or secrets directly in your Postman collection. Use environment variables for these values.
  • Organize Your Environments: Create separate environments for different development stages (development, staging, production). This keeps your testing consistent with the environments.
  • Utilize Collections: Group related requests into collections and associate them with relevant environments. This simplifies the management of your API testing projects.

By effectively utilizing environment variables, you can significantly improve your API testing efficiency, reduce code duplication, and increase the robustness of your testing workflows.

API Testing Blog