Set up Postman with ProxyField
- In the desktop app, select the gear icon, then Settings, and open the Proxy tab.
- Turn on Use custom proxy configuration and keep HTTP and HTTPS under Use proxy for.
- Under Proxy server, choose HTTP and enter
gate.proxyfield.ioand7000. - Turn on Proxy auth and enter your username and password from the table.
- Send
GET https://ipinfo.io/jsonand check the IP and country in the response.
Labels can differ slightly between versions.
The same login as one proxy line (host:port:username:password), here with a Canberra sticky session; its four parts go into Postman's host, port, username and password fields.
gate.proxyfield.io:7000:<login>-country-au-region-australian_capital_territory-city-canberra-session-he9f2qga-ttl-60:<password>Postman's own guide to its proxy settings: Configure Postman to use a proxy server (Postman Docs).
On this page 9 sections
How to set up a custom proxy with a username and password in Postman
Eight steps in the desktop app, with the values to enter. Postman's docs say "You can't configure the default proxy in the Postman web app", so use the desktop app.
- Select the gear icon in the header, then Settings (Postman: "Click Settings in the header and click Settings").
Screenshot Postman header with the Settings gear - Open the Proxy tab.
- Under Proxy configurations for sending requests, turn on Use custom proxy configuration.
Screenshot Postman Settings, Proxy tab with Use custom proxy configuration on - Under Use proxy for, keep HTTP and HTTPS selected (the default), so requests to both
http://andhttps://APIs use the proxy. - Under Proxy server, choose HTTP, then enter
gate.proxyfield.ioas the host and7000as the port, with nohttp://before the host. - Turn on Proxy auth ("Turn on this toggle if the proxy server requires basic authentication") and enter your ProxyField username, for example
<login>-country-us, and your password.Screenshot Postman proxy settings with gate.proxyfield.io, port 7000 and Proxy auth - Under Proxy bypass ("Enter a comma-separated list of hosts"), list
localhost,127.0.0.1and any internal API hosts that must not go through the proxy. - Close Settings and send
GET https://ipinfo.io/json. Pass: the response shows the proxy's"ip","country": "US"and its"city", not yours. Fail: your own IP (the proxy is off or bypassed) or an error in the Console (see the fix table).
Read moreShow less
Labels and quotes as in Postman's proxy documentation (Postman Docs: Configure proxy settings). The custom proxy applies to every request the desktop app sends; by default the app uses your system's proxy, and the custom configuration replaces it while it is on.
| Postman setting | ProxyField value |
|---|---|
| Use custom proxy configuration | on |
| Use proxy for | HTTP and HTTPS |
| Proxy server | HTTP (or SOCKS5H / SOCKS5), gate.proxyfield.io, 7000 |
| Proxy auth | on: username <login>-country-us, password from your account |
| Proxy bypass | localhost,127.0.0.1 and your internal hosts |
| Use system proxy | off, or leave it: when both are on, Postman uses the custom proxy |
Proxy auth is basic authentication: a username and a password. The location goes in the username, and every part after the login is optional. Your credentials, the allowlist and the configurator (it generates as many proxy lines as you need) are in your ProxyField account. The same login as one proxy line: gate.proxyfield.io:7000:<login>-country-us:<password>. Mobile 5G/4G proxies cost $3.45/GB for 1 GB down to $2.45/GB from 1,000 GB, on the same gateway and balance. Mobile or residential in the username: residential by default; add -mobile after the login for mobile IPs, as in <login>-mobile-country-us.
The other place a login goes: the default (system) proxy. If you set ProxyField as your operating system's proxy instead (Windows, macOS, Linux), Postman's default proxy configuration uses it, and the login is entered in Postman:
- Settings → Proxy, under Default proxy configuration.
- Select the checkbox This proxy requires authentication and enter your ProxyField username and password.
- Select Save and Restart Postman.
The custom configuration above is simpler for testing: it needs no restart and leaves the rest of your computer on its normal connection.
Does Postman support SOCKS5 proxies?
Yes: Postman supports SOCKS5, and also SOCKS5H, SOCKS4 and SOCKS4A ("Postman supports HTTP, SOCKS5, SOCKS5H, SOCKS4, and SOCKS4A protocols"). Only HTTP and HTTPS requests go through it: "Postman only supports sending HTTP and HTTPS requests through a SOCKS proxy" (Postman Docs: Configure proxy settings).
Read moreShow less
ProxyField's gateway speaks HTTP, HTTPS and SOCKS5 on the same gate.proxyfield.io:7000, with the same username and password. The SOCKS5 values to enter in Settings → Proxy → Use custom proxy configuration:
Use proxy for: HTTP, HTTPS
Proxy server: SOCKS5H gate.proxyfield.io 7000
Proxy auth: on
Username: <login>-country-us
Password: <password>Choose SOCKS5H or SOCKS5 by who should look up the API's host name:
| Proxy server entry | Who looks up the API's host name | When to choose it |
|---|---|---|
| SOCKS5H | the proxy (the "h" is for host name) | The API's DNS answer depends on the country, or you do not want your network's DNS to see the host names. The usual SOCKS choice for geo tests. |
| SOCKS5 | your computer, then the IP goes to the proxy | Your network or policy requires SOCKS5, and the API's host resolves the same everywhere. |
| HTTP | the gateway | The default. HTTPS APIs still run through an encrypted CONNECT tunnel, which the gateway does not decrypt. |
| SOCKS4, SOCKS4A | your computer (SOCKS4) or the proxy (SOCKS4A) | Not for ProxyField: the SOCKS4 protocol carries a user ID but no password, so a username and password login cannot work. |
The "h" meaning is the usual one in proxy tools: in curl, socks5h:// makes the proxy resolve the host name and socks5:// resolves it locally (curl: CURLOPT_PROXY). To cross-check the same login over SOCKS5 outside Postman, run curl -x "socks5h://<login>-country-us:<password>@gate.proxyfield.io:7000" https://api.ipify.org: the answer is the exit IP.
What SOCKS5 in Postman does not carry. ProxyField's gateway also carries UDP over SOCKS5 on residential IPs (HTTP/3, QUIC). Postman's docs name only HTTP and HTTPS requests through a SOCKS proxy, so do not plan on Postman to send UDP through the gateway; use a client built for SOCKS5 UDP for that. More on the protocol: SOCKS5 proxies.
Where to get proxies in many countries for Postman tests
ProxyField covers 195+ countries and 21,000+ cities with 412M+ residential IPs, from $2.95/GB for 1 GB, at the same price in every country and city. Use residential for an API's answers by country or city, mobile for what an app's API returns to phone users, and a dedicated ISP IP for an API that allowlists one fixed address (the table below has the prices). Postman holds one custom proxy at a time, so the country goes in the Proxy auth username:
| Exit | Username |
|---|---|
| Germany | <login>-country-de |
| Japan | <login>-country-jp |
| Brazil | <login>-country-br |
| New York | <login>-country-us-region-new_ |
Read moreShow less
Change the username, send GET https://ipinfo.io/json and check that "country" reads DE, JP or BR, then send the request you are testing. A geo check like this is a few KB: at an example 5 KB per check, 1 GB for $2.95 covers about 200,000 checks. Without a session, every request gets a new IP. When an API ties a token or a cookie to the IP, add a sticky session, -session-<id>-ttl-<seconds>, which holds one IP for 30 s to 36 h (20 minutes by default). An IP idle for 120 s is replaced, and if its exit node drops the IP can change.
To get every country in one run, run your collection with Newman once per country. Newman reads the proxy from the environment:
for cc in us de jp br; do
HTTPS_PROXY="http://<login>-country-$cc:<password>@gate.proxyfield.io:7000" \
HTTP_PROXY="http://<login>-country-$cc:<password>@gate.proxyfield.io:7000" \
newman run collection.json --env-var "country=$cc" \
--reporters cli,json --reporter-json-export "run-$cc.json"
doneEach run writes run-<cc>.json, so you can compare the API's answers by country. Test APIs you own or are allowed to test, and avoid sending production credentials through any third-party network. The same loop works in cURL, Python or Node.js.
System proxy, environment variables and Newman
| Where requests run | How it picks up a proxy |
|---|---|
| Postman desktop, default | the operating system's proxy (Use system proxy) |
| Postman desktop, Use system proxy with the environment option on | also HTTP_PROXY, HTTPS_PROXY and NO_PROXY from the operating system |
| Postman desktop, custom proxy on | the values in Settings → Proxy; the custom proxy wins when both are on |
| Newman (command line) | HTTP_PROXY, HTTPS_PROXY and NO_PROXY in the environment |
Watch for leftover variables. If HTTP_PROXY or HTTPS_PROXY is set in your operating system, it can override Postman's own settings, and your requests keep going out the old way. Remove the variables, or start Postman from a script that clears them, as Postman's troubleshooting advises.
Setting the system proxy is covered for Windows, macOS and Linux.
Postman's capture proxy is something else
Postman also has its own built-in proxy (Capture requests), which records traffic from a phone or browser into a collection. That proxy runs on your computer and changes nothing about your IP. The settings on this page go the other direction: they send Postman's own requests out through ProxyField.
Check and fix the proxy in Postman
- Send
GET https://api.ipify.org: the body is the exit IP, not yours.GET https://ipinfo.io/jsonshows its city and country. - Open the Console (bottom bar) to see each request and any network error.
| Symptom | Likely cause | Fix |
|---|---|---|
Postman shows 407 Proxy Authentication Required (HTTP's generic status for a proxy that wants a login) | Proxy auth off, or a typo in the username or password | Turn Proxy auth on and check both fields for spaces and typos; see 407 Proxy Authentication Required |
| Requests ignore the custom proxy | HTTP_PROXY or HTTPS_PROXY set in the operating system | Remove them, or start Postman from a script that clears them (below) |
| Requests fail on a network that needs no proxy | Use system proxy or Use custom proxy configuration is still on, or old proxy variables are set | Turn both off, as Postman's troubleshooting says; then clear HTTP_PROXY, HTTPS_PROXY, http_proxy and https_proxy |
Error: tunneling socket could not be established | Wrong host or port, http:// typed in the host field, or a firewall | Host gate.proxyfield.io, port 7000; allow outgoing port 7000 |
| HTTPS requests go direct | HTTPS not selected under Use proxy for | Select both |
| SSL errors only through the proxy | A company proxy or security software intercepts HTTPS | Add its CA certificate in Settings → Certificates, or turn off SSL verification for local tests only |
| Internal APIs fail | They go through the proxy too | Add them to Proxy bypass |
| An API rejects the IP | The API blocks that IP or region, or a restricted category | Try another city or a sticky session; some site categories are restricted to protect the network, including financial and government services |
Read moreShow less
Start Postman without proxy variables. Postman's docs give a postman.sh (macOS, Linux) or postman.bat (Windows) that empties the variables and then launches the app. The same idea on macOS or Linux:
# postman.sh: start Postman with no proxy variables in its environment
env -u HTTP_PROXY -u HTTPS_PROXY -u http_proxy -u https_proxy "<path to Postman>" &Gateway error messages: 407 Proxy Authentication Required for a wrong login or password, an IP not on the allowlist or a malformed location, 402 Payment Required when no traffic is left and 502 Bad Gateway when no exit could be connected; a restricted site gets no separate response, and a 403 comes from the site itself. Status codes are explained in proxy errors. Our 24/7 live chat helps with setup and integration.
Which proxies to use with Postman
| What you test | Proxy | Price |
|---|---|---|
| An API's answers by country or city | Residential | from $1.95/GB ($2.95 for 1 GB) |
| What a mobile app's API returns to phone users | Mobile 5G/4G | from $2.45/GB ($3.45 for 1 GB) |
| An API that allowlists one fixed IP | Dedicated ISP | from $2.29 per IP per 30 days |
If you would rather receive the pages than run the proxies, ProxyField's Web Scraping API is designed to fetch any URL, plain HTTP or with JS rendering: $0.50 down to $0.20 per 1,000 successful results for HTTP and $2.00 down to $1.00 with JS rendering, billed on successful results only. It is in development; the planned requests are in the API documentation, and access is through Contact sales. Use ProxyField for lawful work such as testing tools from a selected region and collecting public data, within our acceptable use policy.
Get started
Start with the Easy Trial: 1 GB for $2.95, with no minimum purchase and no subscription. The traffic never expires and all purchases are final. See pricing per GB.
Postman Proxy Setup FAQ
How do I use a proxy in Postman?
ProxyField proxies work in Postman from $1.95/GB ($2.95 for 1 GB): in Settings → Proxy, turn on Use custom proxy configuration, choose HTTP in Proxy server and enter gate.proxyfield.io and port 7000. Turn on Proxy auth with your username and password, then send GET https://ipinfo.io/json to confirm the IP and country.
How do I set up a custom proxy with a username and password in Postman's proxy settings?
In the Postman desktop app, select the gear icon, then Settings, open the Proxy tab and turn on Use custom proxy configuration; enter the host and port under Proxy server (no http://), then turn on Proxy auth and type the username and password. With ProxyField, that is gate.proxyfield.io, port 7000 and a username such as <login>-country-us, from $2.95 for 1 GB. Postman's docs say the default proxy can't be configured in the web app. If the login belongs to your system proxy instead, use Default proxy configuration, select This proxy requires authentication and then Save and Restart Postman.
Where can I get proxies in several countries for testing geo-specific API responses from Postman?
ProxyField covers 195+ countries and 21,000+ cities with 412M+ residential IPs from $1.95/GB, at the same price in every country. One login works for all of them: put the country in the Postman Proxy auth username (<login>-country-de, -country-jp, -country-br) and check the exit with GET https://ipinfo.io/json. Start with the Easy Trial, 1 GB for $2.95.
Where are the proxy settings in Postman?
In the desktop app, select the gear icon, then Settings, then the Proxy tab. Under Proxy configurations for sending requests it holds Use system proxy, Use custom proxy configuration and the Proxy bypass list.
Should I tick HTTP or HTTPS under "Use proxy for" in Postman?
Both, which is the default. Use proxy for chooses which requests go through the proxy, so with only HTTP selected, requests to https:// APIs go direct. HTTPS requests still run through an encrypted tunnel to the API.
Does Postman use the system proxy settings?
Yes, by default the desktop app uses your operating system's proxy, and it can also read HTTP_PROXY, HTTPS_PROXY and NO_PROXY. When Use custom proxy configuration is on as well, Postman uses the custom proxy.
Does Postman support SOCKS5 proxies, or can it only use HTTP and HTTPS proxies?
Yes: Postman supports SOCKS5, and also SOCKS5H, SOCKS4 and SOCKS4A, but only HTTP and HTTPS requests go through a SOCKS proxy. Choose SOCKS5H if the proxy should resolve host names, SOCKS5 to resolve them on your computer; SOCKS4 cannot send a password. ProxyField's gateway accepts SOCKS5 on the same gate.proxyfield.io:7000 with the same username and password as HTTP.
Should I pick SOCKS5 or SOCKS5H in Postman?
SOCKS5H, when the proxy should look up the API's host name: your computer's DNS is not used, and the name resolves at the exit. SOCKS5 resolves the name on your computer and sends the proxy an IP address. Both work with ProxyField's gate.proxyfield.io:7000 and the same login.
Can I set a proxy in the Postman web app?
No: Postman's docs say "You can't configure the default proxy in the Postman web app", and the custom proxy settings are in the desktop app's Settings → Proxy. Install the desktop app to send requests through ProxyField's gateway.
How do I use a SOCKS5 proxy with Postman?
In Settings → Proxy → Use custom proxy configuration, choose SOCKS5 in the Proxy server dropdown, enter the host and port, and add the login under Proxy auth. Only HTTP and HTTPS requests go through it.
Show 10 more questionsShow fewer questions
Why does Postman ignore my proxy settings?
Usually because HTTP_PROXY or HTTPS_PROXY is set in your operating system and overrides Postman's settings. Remove those variables, or start Postman from a script that clears them, and send the request again.
Can a proxy be used for a single request in Postman?
No, the proxy setting applies to every request the app sends; use Proxy bypass to exclude hosts. For a one-off request through a proxy, curl with -x is quicker.
How do you fix error 407 in Postman?
407 is HTTP's generic "Proxy Authentication Required": the proxy did not accept the login. Turn on Proxy auth and enter the username and password from your ProxyField account, with no spaces around them.
What is the Postman proxy for capturing requests?
Postman's built-in capture proxy records traffic from a browser or phone into a collection. It runs on your computer and doesn't change your IP; sending Postman's requests through another IP is the custom proxy setting.
Why bother with a proxy in Postman?
To see what an API returns to users in another country or city, to test geo rules and rate limits per IP, or to reach an API that allowlists a fixed IP. Without a proxy, every request comes from your own address.
Should I use cURL or Postman to test a proxy?
cURL for a quick check or a script, because -x sets the proxy per command. Postman for exploring an API with saved requests, with the proxy set once in Settings.
What is Postman?
A desktop and web app for building, sending and testing HTTP API requests, with collections, environments and a command-line runner, Newman. Its desktop app has its own proxy settings.
Can I call the Web Scraping API from Postman?
ProxyField's Web Scraping API is in development and available through Contact sales. Its design is a POST with a JSON body and an Authorization: Bearer <api_key> header, which Postman can send. Prices: $0.50 down to $0.20 per 1,000 successful results ($2.00 down to $1.00 with JS rendering).
Does Newman use a proxy?
Newman reads HTTP_PROXY, HTTPS_PROXY and NO_PROXY from the environment, not the desktop app's settings. Export them before newman run, for example in your CI job, or set them per run to test several countries.
Why does Postman show SSL errors through a proxy?
Something on the path presents its own certificate, usually a company proxy or security software that inspects HTTPS. Add its CA certificate in Settings → Certificates rather than turning off verification for real traffic.