Skip to content
Get Started
G2G2
4.7/5
Excellent
Trustpilot

How to use a proxy in Postman

In the Postman desktop app, open Settings → Proxy and turn on Use custom proxy configuration. Keep HTTP and HTTPS ticked under Use proxy for, choose HTTP as the Proxy server type, enter your CleanProxies host and port, then turn on Proxy auth and enter your username and password.

Try Now for $4.99Continue with Google
  • Session Control
  • High Speed
  • Privacy First

What you need

Postman sends every API call from your own machine, so the API sees your office or home IP. Routing it through a CleanProxies static ISP proxy gives your requests one fixed US address you can add to your own API firewall allowlist, and lets you check how a geo-aware endpoint answers callers from the US.

Your credential line

From the dashboard's proxy manager: host (or IP), port, username and password. Convert lists with the proxy list formatter.

Postman ready

  • The Postman desktop app (the proxy settings below live in the desktop app's Settings).
  • One proxy line from your dashboard, split into host, port, username and password.

Which proxy fits Postman?

Both products use the same setup in Postman. What changes is how long an IP stays with you.

Static ISP Proxies

Best fit

Recommended. Every request leaves from one dedicated US ISP IP that stays the same all month, so you can add it once to your own API gateway or firewall allowlist and test from a fixed US location with unlimited bandwidth.

starting from$0.75/IP

Dedicated static IPs registered to US and Canadian ISPs. The address stays the same for as long as you hold it, with unlimited bandwidth and HTTP(S) or SOCKS5 access.

Buy NowSee Static ISP Proxies features

Rotating Residential Proxies

Also works

Use a sticky residential line when you need to see how your API answers callers from a specific country; the IP holds for the session length you chose. A rotating line can change IP between requests, which makes a series of calls hard to compare.

starting from$0.63/GB

Residential IPs in 190+ countries with country, state and city targeting. Rotate on every request or hold a sticky session for up to 90 minutes; GB never expire.

Buy NowSee Rotating Residential Proxies features
credentials

Your CleanProxies credentials

Every product connects over HTTP(S); static ISP and ISP subnet proxies also run SOCKS5 and IP whitelisting. This is what the dashboard gives you to paste into Postman.

Static ISP and ISP subnetHTTP(S)SOCKS5IP whitelist
IP:PORT:USER:PASS

One line per dedicated IP. With IP whitelisting on, the line is just IP:PORT and no password is sent.

Rotating residential and mobileHTTP(S)User:pass
HOST:PORT:USER:PASS

Generated in the proxy manager. The username carries the location and session you pick, so generate a new list to change them.

As a URL, for code and most toolshttp://USERNAME:PASSWORD@HOST:PORTsocks5://USERNAME:PASSWORD@HOST:PORT

Use http:// even for HTTPS websites; the TLS session still runs end to end. The socks5:// form is for static ISP and ISP subnet proxies.

How to set up CleanProxies in Postman

Four steps, then check the exit IP with the free proxy checker.

  1. 1

    Open the proxy settings

    Click the settings icon in the header, choose Settings, then open the Proxy tab.

  2. 2

    Turn on the custom proxy

    Under the proxy configurations for sending requests, turn on Use custom proxy configuration. Keep HTTP and HTTPS selected in Use proxy for.

  3. 3

    Enter the proxy server

    In Proxy server, pick HTTP in the dropdown, then type the CleanProxies host (without http://) and the port in their own boxes.

  4. 4

    Add the credentials

    Turn on Proxy auth and enter your username and password. With an ISP proxy on IP whitelisting, leave Proxy auth off. Close Settings and send a request.

settings

Postman proxy settings

Replace the highlighted placeholders with the values from your dashboard.

Postman + CleanProxies

Verify your exit IP

Post-response scriptJavaScript
pm.test("Request left through the proxy", () => {
  const { ip } = pm.response.json();
  console.log("Exit IP:", ip);
  pm.expect(ip).to.be.a("string");
});

Postman's proxy fields, one by one

  • Use proxy for: the request types that go through the proxy. HTTP and HTTPS are both selected by default; if you untick HTTPS, https:// requests leave from your own IP.
  • Proxy server: a protocol dropdown (HTTP, SOCKS5, SOCKS5H, SOCKS4, SOCKS4A), a host box and a port box. Choose HTTP for every CleanProxies product. SOCKS5H works only with static ISP proxies after you switch SOCKS5 on for that proxy list in the dashboard (same username and password).
  • Proxy auth: basic authentication with Username and Password. Leave it off only when the ISP proxy is set to IP whitelisting.
  • Proxy bypass: a comma-separated list of hosts that skip the proxy, for example localhost,127.0.0.1,api.internal.example.

Custom proxy, system proxy and the capture proxy

The custom proxy is the one you want: it sends the requests you build in Postman out through CleanProxies. Use system proxy instead follows your operating system's proxy and can also read HTTP_PROXY, HTTPS_PROXY and NO_PROXY; if both are on, Postman uses the custom proxy.

Postman's built-in capture proxy is a different feature. It listens on your machine to record traffic from a browser or another app into Postman. It doesn't send anything through CleanProxies, so don't point it at your proxy line.

fix it fast

Troubleshooting Postman proxy errors

Verify your exit IP

Create a GET request to https://api.ipify.org?format=json and click Send. The response is the IP the API sees; it should be your proxy's address, not yours. The Post-response script below prints it to the Postman Console for every run.

Open What is my IP? through the proxy to see the address and headers a website receives, or paste up to ten lines into the free proxy checker to test connectivity, latency and exit IP.

Still stuck? Our 24/7 support team answers fast: contact us with the error and the line you used (leave the password out).

Postman error fixes
  • 407 Proxy Authentication RequiredWhy: Proxy auth is off, or the password has a typo or a trailing space.Turn on Proxy auth and paste the username and password again from the dashboard.
  • Could not get response / tunnel errorsWhy: http:// typed into the host box, the wrong port, or a SOCKS type selected for a residential line.Enter only the host in the host box, the port in the port box, and choose HTTP in the dropdown.
  • HTTPS requests still show your own IPWhy: HTTPS is unticked in Use proxy for.Select both HTTP and HTTPS under Use proxy for.
  • Calls to localhost or an internal API failWhy: They are sent to the proxy, which can't reach your local network.Add those hosts to Proxy bypass, separated by commas.

Postman proxy guides

Setup guides and best practices from the CleanProxies blog.

Get the latest insightsAll Blogs

More integrations

Setup guides for tools people run next to Postman.

All integrations

Postman proxy FAQs

Straight answers about running CleanProxies in Postman.

In the desktop app: the settings icon in the header, then Settings, then the Proxy tab. Turn on Use custom proxy configuration to enter your own proxy.

Got more questions?All FAQs