Environment switching in Postman

Introduction

Environment switching helps you run the same tests with different settings easily. It saves time and avoids mistakes when testing in multiple places.

Testing the same API on development, staging, and production servers.

Running tests with different user credentials or tokens.

Switching between different database connections during testing.

Testing features that behave differently based on environment variables.

Sharing tests with teammates who use different setups.

Syntax

Postman

1. Create environments in Postman with variables (e.g., baseUrl).
2. Use {{variableName}} in your requests (e.g., {{baseUrl}}/api/users).
3. Select the environment from the dropdown before running tests.

Use double curly braces {{}} to insert environment variables in URLs, headers, or body.

Switching environments changes variable values without editing requests.

Examples

This sends the request to the development server using the baseUrl variable.

Postman

Environment variables:
baseUrl = https://dev.example.com

Request URL:
{{baseUrl}}/api/login

Switching environment to production changes the baseUrl automatically.

Postman

Environment variables:
baseUrl = https://prod.example.com

Request URL:
{{baseUrl}}/api/login

Authorization header uses the token from the selected environment.

Postman

Using token variable:
accessToken = abc123

Header:
Authorization: Bearer {{accessToken}}

Sample Program

This test checks if the API status endpoint returns 200 OK. By switching environment, the same test runs on dev or prod servers.

Postman

/* Postman test script example */

// Environment variables setup:
// dev environment: baseUrl = https://dev.example.com
// prod environment: baseUrl = https://prod.example.com

// Request URL:
// {{baseUrl}}/api/status

// Test script to check response status
pm.test("Status code is 200", function () {
    pm.response.to.have.status(200);
});

Important Notes

Always define all needed variables in each environment to avoid missing values.

Use descriptive environment names to avoid confusion.

Remember to select the correct environment before running your tests.

Summary

Environment switching lets you reuse tests with different settings easily.

Use {{variable}} syntax to insert environment variables in requests.

Select the environment in Postman to change variable values automatically.