Postman is the most popular API testing platform with a visual interface and CLI runner. Configure KnoxProxy in Postman to test APIs from different geographic locations, verify geo-fenced endpoints, and debug region-specific API responses without deploying test infrastructure.
In Postman desktop, go to Settings (gear icon) > Proxy. Enable "Use custom proxy configuration".
// Postman GUI path:
// Settings > Proxy > Use custom proxy configuration
// Proxy Server: gw.knoxproxy.com
// Port: 7000
// Check both HTTP and HTTPSIn the same proxy settings panel, enable "Proxy requires authentication" and enter your KnoxProxy credentials.
// Proxy Auth:
// Username: USER
// Password: PASSTo target a specific country, append the country code to the username field.
// Username: USER-country-jp
// This routes all Postman requests through a Japanese IPSend a GET request to httpbin.org/ip to verify the proxy is working.
GET https://httpbin.org/ip
// Expected response:
// { "origin": "x.x.x.x" } <-- KnoxProxy exit IPFor CI/CD pipelines, use Newman with proxy environment variables.
HTTP_PROXY=http://USER:PASS@gw.knoxproxy.com:7000 \
HTTPS_PROXY=http://USER:PASS@gw.knoxproxy.com:7000 \
newman run collection.jsonTarget a specific country in Newman by changing the proxy username.
HTTP_PROXY=http://USER-country-au:PASS@gw.knoxproxy.com:7000 \
HTTPS_PROXY=http://USER-country-au:PASS@gw.knoxproxy.com:7000 \
newman run collection.json --reporters cli,json#!/bin/bash
# Run Postman collection through KnoxProxy via Newman
# Basic proxy routing
HTTP_PROXY=http://USER:PASS@gw.knoxproxy.com:7000 \
HTTPS_PROXY=http://USER:PASS@gw.knoxproxy.com:7000 \
newman run my-collection.json \
--environment production.json \
--reporters cli,json \
--reporter-json-export results.json
# Country-targeted run (Germany)
HTTP_PROXY=http://USER-country-de:PASS@gw.knoxproxy.com:7000 \
HTTPS_PROXY=http://USER-country-de:PASS@gw.knoxproxy.com:7000 \
newman run my-collection.json \
--environment production.json \
--folder "Geo Tests"Each Postman request opens a new connection and gets a fresh proxy IP. For sticky sessions, use USER-session-{id} in the proxy username field to maintain the same IP across a collection run.
| Problem | Fix |
|---|---|
| Error: connect ECONNREFUSED | Verify proxy is enabled in Settings > Proxy. Check that gw.knoxproxy.com:7000 is reachable. |
| 407 Proxy Authentication Required | Enable "Proxy requires authentication" and verify username and password. For Newman, check env var format. |
USER-country-de-city-berlin-session-profile07Order matters -- geo flags before the session flag. The session name is free text; use the profile ID so the mapping is self-documenting. Password stays as issued; no flags belong there. HTTP on :7000, SOCKS5 on :7001, same credentials.
Yes, Postman has a built-in proxy configuration panel under Settings > Proxy, where you enable custom proxy configuration and enter the KnoxProxy server, port 7000, and username/password fields directly in the GUI. No plugins or environment variables are required for the desktop app to authenticate through the proxy.
Yes, Newman inherits the standard HTTP_PROXY and HTTPS_PROXY environment variables from the shell that launches it, the same way k6 and other CLI tools do. Set them as pipeline environment variables in your CI configuration before the newman run collection.json command executes, and every request routes through KnoxProxy.
When enabled in Settings > Proxy, KnoxProxy routes every request sent from that Postman workspace, both manual requests and collection runs. Use the "Proxy Bypass" list in the same settings panel to exclude specific domains, such as internal or localhost endpoints, from being routed through the proxy at all.
In the desktop GUI, update the proxy username field in Settings > Proxy, for example to USER-country-au, before sending each request that needs a different country. In Newman, run separate commands with different HTTP_PROXY usernames instead, since the CLI reads the proxy configuration once per invocation rather than per request.
Rotating residential proxies -- 2 minutes setup, instant activation, 14-day money-back guarantee.