API client
WeProxy Proxy Setup For Postman
Postman Desktop can use the system proxy or a custom proxy that applies only to Postman requests. For API testing without affecting other apps, a custom configuration gives you more control. Postman’s built-in capture proxy is not the same as an external WeProxy proxy.
Postman Desktop can use the system proxy setting or define a custom proxy for Postman requests only. If you want to use WeProxy for API testing without affecting other apps, custom proxy configuration gives you more control.
The external proxy setting Postman uses to send requests is not the same as Postman’s built-in proxy for capturing incoming traffic. This guide covers the external WeProxy connection.
Required WeProxy Details
| Postman field | WeProxy value |
|---|---|
| Proxy server | Host |
| Port | Port |
| Proxy type | HTTP or SOCKS |
| Proxy auth username | Username |
| Proxy auth password | Password |
Configuring a Custom Proxy in Postman
- Open the Postman Desktop app.
- Click the Settings icon in the header, then select Settings.
- Go to the Proxy tab.
- Enable Use custom proxy configuration.
- Under Use proxy for, choose whether HTTP and/or HTTPS requests should go through the proxy.
- Set the proxy type to HTTP or SOCKS, depending on your WeProxy product.
- In Proxy server, enter only the host, without an
http://orsocks5://prefix. - Enter your WeProxy port in the port field.
- If a username and password are required, turn on Proxy auth and enter your credentials.
- To exclude addresses from the proxy, list them in Proxy bypass, separated by commas.
When the custom proxy is enabled, it takes precedence over the system proxy setting. To avoid confusion, keep only the method you need enabled.
Using the System Proxy Setting
If you have already configured WeProxy system-wide on Windows or macOS:
- In Postman, open Settings > Proxy.
- Enable Use system proxy.
- Turn off Use custom proxy configuration.
- If the system proxy requires authentication, enter the username and password in Default proxy configuration.
- Save and restart Postman.
Testing a Request
Create a new GET request:
https://api.ipify.org?format=json
Click Send. The response should show your WeProxy exit IP. You can then test your actual API endpoint.
Postman Proxy Errors
407 Proxy Authentication Required
Check the Proxy auth setting and your credentials. Make sure the host field doesn't include a protocol.
Postman uses the system proxy instead of the custom proxy
According to the Postman docs, the custom proxy takes precedence when it's enabled. To keep things simple, turn off the option you aren't using and restart Postman.
Requests fail through a SOCKS proxy
Postman routes HTTP and HTTPS requests through a SOCKS proxy. Confirm that the SOCKS version you selected matches your WeProxy product.
SSL certificate error
Instead of permanently disabling certificate verification, check the certificate chains of the proxy and the destination server. If a corporate CA is required, add the trusted CA file in Postman’s certificate settings.
Source
Other integrations
Looking for another tool?
Get Started
Get connected with WeProxy now
Create an account, use 1 GB of free residential traffic right away, and follow the steps above in your own setup.









