Skip to content
Postman API Testing Tips

How To Use Dynamic Variables In Postman

API Testing Blog

Using Dynamic Variables in Postman for API Testing

Dynamic variables are powerful tools in Postman, enabling you to create flexible and reusable API tests. They allow you to store and manipulate data within your requests and tests, making them more adaptable and efficient. This guide will explore various ways to use dynamic variables in Postman for API testing.

1. Defining Dynamic Variables

Postman provides several methods to define dynamic variables:

1.1 Environment Variables:

These variables are accessible across multiple requests and collections. They are often used to store secrets, credentials, or configurations.

1.1.1 Setting Environment Variables:

  • Navigate to the Environment tab in Postman.
  • Click the Add button and provide a name for the variable.
  • Enter the value you want to assign.

1.1.2 Example:

{
  "baseUrl": "https://api.example.com",
  "apiKey": "your_api_key"
}

1.2 Global Variables:

Global variables are accessible throughout your Postman workspace. They are suitable for holding common values used across multiple projects.

1.2.1 Setting Global Variables:

  • Navigate to the Global tab in Postman.
  • Click the Add button and provide a name for the variable.
  • Enter the value you want to assign.

1.2.2 Example:

{
  "userAgent": "PostmanRuntime/7.26.0"
}

1.3 Data Variables:

Data variables are useful for storing and iterating through data sets, enabling you to test multiple scenarios.

1.3.1 Creating Data Files:

  • Create a .json or .csv file containing your data.
  • For example: data.json

1.3.2 Setting Data Variables:

  • In your Postman request, navigate to the Data tab.
  • Select the data file you created.
  • Postman will automatically create data variables based on the file structure.

1.3.3 Example:

[
  {
    "userId": 1,
    "username": "john.doe"
  },
  {
    "userId": 2,
    "username": "jane.doe"
  }
]

2. Using Dynamic Variables in Requests

You can use dynamic variables in your Postman requests, including:

2.1 URL Parameters:

  • Use curly braces {{ }} to embed variables within the URL.
  • Example: https://api.example.com/users/{{userId}}

2.2 Headers:

  • Include variables in the request headers.
  • Example: Authorization: Bearer {{apiKey}}

2.3 Body:

  • Use variables in the request body (JSON, XML, or form data).
  • Example:
{
  "name": "{{name}}",
  "email": "{{email}}"
}

3. Working with Dynamic Variables in Tests

You can access and manipulate dynamic variables in your Postman tests using the pm object.

3.1 Accessing Variables:

  • Use pm.environment.get() to retrieve environment variables.
  • Use pm.globals.get() to retrieve global variables.
  • Use pm.iterationData.get() to retrieve data variables.

3.1.1 Example:

pm.test("Check user name", () => {
  const userName = pm.environment.get("userName");
  pm.expect(pm.response.json().name).to.be.equal(userName);
});

3.2 Setting Variables:

  • Use pm.environment.set() to set environment variables.
  • Use pm.globals.set() to set global variables.

3.2.1 Example:

pm.test("Extract user ID", () => {
  const userId = pm.response.json().id;
  pm.environment.set("userId", userId);
});

4. Dynamic Variables in Collections

Dynamic variables can be used in collections to create flexible and reusable workflows.

4.1 Setting Variables in Collection Runner:

  • You can define variables at the collection level using the Collection Runner.
  • This allows you to run tests with different data sets without modifying individual requests.

4.1.1 Example:

  • In the Collection Runner, set the variable environment to Staging or Production.
  • This variable can be used in your tests to target specific API endpoints based on the environment.

4.2 Generating Random Values:

Postman provides functions to generate random data for variables.

4.2.1 Example:

pm.test("Generate random email", () => {
  const email = `${pm.variables.replaceIn("user.{{randomInt}}@example.com")}`;
  pm.environment.set("email", email);
});

5. Best Practices for Using Dynamic Variables

  • Use descriptive variable names.
  • Keep variables organized and well-documented.
  • Limit the scope of variables to the necessary level.
  • Use environment variables for secrets and configurations.
  • Utilize data variables for testing different scenarios.
  • Leverage random data generation to test edge cases.

6. Conclusion

Using dynamic variables effectively can significantly enhance your API testing workflows. It allows you to create more adaptable, reusable, and robust tests, allowing you to cover a wider range of scenarios and reduce redundancy.

API Testing Blog