How to Use Proxies with Postman: Complete Guide

TL;DR

Configure GProxy proxies in Postman for API testing from different locations. Covers global proxy settings, per-request configuration, and environment variables.

Get Proxies → Postman website →

Language: GUI / API Client

Prerequisites

✓[
✓"
✓P
✓o
✓s
✓t
✓m
✓a
✓n
✓
✓d
✓e
✓s
✓k
✓t
✓o
✓p
✓
✓a
✓p
✓p
✓
✓i
✓n
✓s
✓t
✓a
✓l
✓l
✓e
✓d
✓"
✓,
✓
✓"
✓G
✓P
✓r
✓o
✓x
✓y
✓
✓a
✓c
✓c
✓o
✓u
✓n
✓t
✓
✓w
✓i
✓t
✓h
✓
✓a
✓c
✓t
✓i
✓v
✓e
✓
✓p
✓r
✓o
✓x
✓y
✓
✓p
✓l
✓a
✓n
✓"
✓,
✓
✓"
✓B
✓a
✓s
✓i
✓c
✓
✓f
✓a
✓m
✓i
✓l
✓i
✓a
✓r
✓i
✓t
✓y
✓
✓w
✓i
✓t
✓h
✓
✓P
✓o
✓s
✓t
✓m
✓a
✓n
✓
✓r
✓e
✓q
✓u
✓e
✓s
✓t
✓s
✓
✓a
✓n
✓d
✓
✓c
✓o
✓l
✓l
✓e
✓c
✓t
✓i
✓o
✓n
✓s
✓"
✓]

Step-by-Step Setup

[

{

"

T

I

T

L

E

"

:

"

O

P

E

N

P

O

S

T

M

A

N

P

R

O

X

Y

S

E

T

I

N

G

S

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

N

A

V

I

G

A

T

E

T

O

S

E

T

I

N

G

S

>

P

R

O

X

Y

"

,

"

C

O

D

E

"

:

"

S

100

E

101

T

102

T

103

I

104

N

105

G

106

S

107

108

(

109

G

110

E

111

A

112

R

113

114

I

115

C

116

O

117

N

118

)

119

120

\

121

U

122

2

123

1

124

9

125

2

126

127

P

128

R

129

O

130

X

131

Y

132

133

\

134

U

135

2

136

1

137

9

138

2

139

140

E

141

N

142

A

143

B

144

L

145

E

146

147

'

148

U

149

S

150

E

151

152

C

153

U

154

S

155

T

156

O

157

M

158

159

P

160

R

161

O

162

X

163

Y

164

165

C

166

O

167

N

168

F

169

I

170

G

171

U

172

R

173

A

174

T

175

I

176

O

177

N

178

'

179

"

180

}

181

,

182

183

{

184

"

185

T

186

I

187

T

188

L

189

E

190

"

191

:

192

193

"

194

C

195

O

196

N

197

F

198

I

199

G

200

U

201

R

202

E

203

204

G

205

P

206

R

207

O

208

X

209

Y

210

"

211

,

212

213

"

214

D

215

E

216

S

217

C

218

R

219

I

220

P

221

T

222

I

223

O

224

N

225

"

226

:

227

228

"

229

E

230

N

231

T

232

E

233

R

234

235

G

236

P

237

R

238

O

239

X

240

Y

241

242

P

243

R

244

O

245

X

246

Y

247

248

D

249

E

250

T

251

A

252

I

253

L

254

S

255

"

256

,

257

258

"

259

C

260

O

261

D

262

E

263

"

264

:

265

266

"

267

P

268

R

269

O

270

X

271

Y

272

273

S

274

E

275

R

276

V

277

E

278

R

279

:

280

281

P

282

R

283

O

284

X

285

Y

286

.

287

G

288

P

289

R

290

O

291

X

292

Y

293

.

294

N

295

E

296

T

297

\

298

N

299

P

300

O

301

R

302

T

303

:

304

305

1

306

0

307

0

308

0

309

\

310

N

311

P

312

R

313

O

314

X

315

Y

316

317

A

318

U

319

T

320

H

321

:

322

323

O

324

N

325

\

326

N

327

U

328

S

329

E

330

R

331

N

332

A

333

M

334

E

335

:

336

337

Y

338

O

339

U

340

R

341

_

342

U

343

S

344

E

345

R

346

\

347

N

348

P

349

A

350

S

351

S

352

W

353

O

354

R

355

D

356

:

357

358

Y

359

O

360

U

361

R

362

_

363

P

364

A

365

S

366

S

367

"

368

}

369

,

370

371

{

372

"

373

T

374

I

375

T

376

L

377

E

378

"

379

:

380

381

"

382

C

383

R

384

E

385

A

386

T

387

E

388

389

E

390

N

391

V

392

I

393

R

394

O

395

N

396

M

397

E

398

N

399

T

400

401

V

402

A

403

R

404

I

405

A

406

B

407

L

408

E

409

S

410

"

411

,

412

413

"

414

D

415

E

416

S

417

C

418

R

419

I

420

P

421

T

422

I

423

O

424

N

425

"

426

:

427

428

"

429

S

430

T

431

O

432

R

433

E

434

435

P

436

R

437

O

438

X

439

Y

440

441

C

442

O

443

N

444

F

445

I

446

G

447

448

I

449

N

450

451

V

452

A

453

R

454

I

455

A

456

B

457

L

458

E

459

S

460

461

F

462

O

463

R

464

465

E

466

A

467

S

468

Y

469

470

S

471

W

472

I

473

T

474

C

475

H

476

I

477

N

478

G

479

"

480

,

481

482

"

483

C

484

O

485

D

486

E

487

"

488

:

489

490

"

491

P

492

R

493

O

494

X

495

Y

496

_

497

H

498

O

499

S

500

T

501

:

502

503

P

504

R

505

O

506

X

507

Y

508

.

509

G

510

P

511

R

512

O

513

X

514

Y

515

.

516

N

517

E

518

T

519

\

520

N

521

P

522

R

523

O

524

X

525

Y

526

_

527

P

528

O

529

R

530

T

531

:

532

533

1

534

0

535

0

536

0

537

\

538

N

539

P

540

R

541

O

542

X

543

Y

544

_

545

U

546

S

547

E

548

R

549

:

550

551

Y

552

O

553

U

554

R

555

_

556

U

557

S

558

E

559

R

560

\

561

N

562

P

563

R

564

O

565

X

566

Y

567

_

568

P

569

A

570

S

571

S

572

:

573

574

Y

575

O

576

U

577

R

578

_

579

P

580

A

581

S

582

S

583

"

584

}

585

,

586

587

{

588

"

589

T

590

I

591

T

592

L

593

E

594

"

595

:

596

597

"

598

T

599

E

600

S

601

T

602

603

T

604

H

605

E

606

607

P

608

R

609

O

610

X

611

Y

612

"

613

,

614

615

"

616

D

617

E

618

S

619

C

620

R

621

I

622

P

623

T

624

I

625

O

626

N

627

"

628

:

629

630

"

631

S

632

E

633

N

634

D

635

636

A

637

638

R

639

E

640

Q

641

U

642

E

643

S

644

T

645

646

T

647

O

648

649

V

650

E

651

R

652

I

653

F

654

Y

655

656

P

657

R

658

O

659

X

660

Y

661

662

I

663

S

664

665

W

666

O

667

R

668

K

669

I

670

N

671

G

672

"

673

,

674

675

"

676

C

677

O

678

D

679

E

680

"

681

:

682

683

"

684

G

685

E

686

T

687

688

H

689

T

690

T

691

P

692

S

693

:

694

/

695

/

696

H

697

T

698

T

699

P

700

B

701

I

702

N

703

.

704

O

705

R

706

G

707

/

708

I

709

P

710

\

711

N

712

\

713

N

714

E

715

X

716

P

717

E

718

C

719

T

720

E

721

D

722

723

R

724

E

725

S

726

P

727

O

728

N

729

S

730

E

731

:

732

\

733

N

734

{

735

\

736

"

737

O

738

R

739

I

740

G

741

I

742

N

743

\

744

"

745

:

746

747

\

748

"

749

<

750

P

751

R

752

O

753

X

754

Y

755

_

756

I

757

P

758

>

759

\

760

"

761

}

762

"

763

}

764

,

765

766

{

767

"

768

T

769

I

770

T

771

L

772

E

773

"

774

:

775

776

"

777

U

778

S

779

E

780

781

N

782

E

783

W

784

M

785

A

786

N

787

788

C

789

L

790

I

791

792

W

793

I

794

T

795

H

796

797

P

798

R

799

O

800

X

801

Y

802

"

803

,

804

805

"

806

D

807

E

808

S

809

C

810

R

811

I

812

P

813

T

814

I

815

O

816

N

817

"

818

:

819

820

"

821

R

822

U

823

N

824

825

C

826

O

827

L

828

L

829

E

830

C

831

T

832

I

833

O

834

N

835

S

836

837

W

838

I

839

T

840

H

841

842

P

843

R

844

O

845

X

846

Y

847

848

V

849

I

850

A

851

852

C

853

O

854

M

855

M

856

A

857

N

858

D

859

860

L

861

I

862

N

863

E

864

"

865

,

866

867

"

868

C

869

O

870

D

871

E

872

"

873

:

874

875

"

876

E

877

X

878

P

879

O

880

R

881

T

882

883

H

884

T

885

T

886

P

887

_

888

P

889

R

890

O

891

X

892

Y

893

=

894

H

895

T

896

T

897

P

898

:

899

/

900

/

901

U

902

S

903

E

904

R

905

:

906

P

907

A

908

S

909

S

910

@

911

P

912

R

913

O

914

X

915

Y

916

.

917

G

918

P

919

R

920

O

921

X

922

Y

923

.

924

N

925

E

926

T

927

:

928

1

929

0

930

0

931

0

932

\

933

N

934

N

935

E

936

W

937

M

938

A

939

N

940

941

R

942

U

943

N

944

945

C

946

O

947

L

948

L

949

E

950

C

951

T

952

I

953

O

954

N

955

.

956

J

957

S

958

O

959

N

960

"

961

}

962

]

Code Examples

Why Use Proxies with Postman?

Postman is the most popular API development and testing platform. Adding GProxy proxies to Postman lets you test API responses from different geographic locations, verify rate limiting behavior, and debug geo-restricted endpoints — all from a visual interface. GProxy's 10M+ residential IPs across 150+ countries give you global API testing capabilities.

Global Proxy Configuration

Postman supports global proxy settings that apply to all requests. Navigate to Settings > Proxy to configure GProxy as your default proxy. This is ideal for testing sessions where all requests should go through the same proxy endpoint.

Per-Request Proxy

For more granular control, use Postman's pre-request scripts to set proxy per request or collection. This lets you test the same API endpoint from multiple locations in a single collection run.

Using Environment Variables

Store your GProxy credentials in Postman environment variables to easily switch between proxy configurations. Create variables for proxy host, port, username, and password, then reference them in your proxy settings.

Collection Runner with Proxy

Run entire API test collections through GProxy proxies using the Collection Runner. This is perfect for automated testing of geo-dependent APIs, rate limit validation, and multi-location availability checks.

Postman + Newman CLI

For CI/CD integration, use Newman (Postman's CLI) with system proxy environment variables to route all requests through GProxy. This enables automated API testing pipelines with proxy support.

Use Cases

[

{

"

T

I

T

L

E

"

:

"

G

E

O

-

A

P

I

T

E

S

T

I

N

G

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

T

E

S

T

H

O

W

A

P

I

S

R

E

S

P

O

N

D

T

O

R

E

Q

U

E

S

T

S

F

R

O

M

D

I

F

E

R

E

N

T

C

O

U

N

T

R

I

E

S

U

S

I

N

G

P

R

O

X

Y

'

S

G

E

O

-

T

A

R

G

E

T

E

D

P

R

O

X

I

E

S

.

"

}

,

{

"

T

I

T

L

E

"

:

"

R

A

T

E

L

I

M

I

T

E

S

T

I

N

G

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

V

E

R

I

F

Y

R

A

T

E

L

I

M

I

T

I

N

G

B

E

H

A

V

I

O

R

B

Y

S

E

N

D

I

N

G

R

E

Q

U

E

S

T

S

F

R

O

M

U

L

T

I

P

L

E

I

P

S

T

H

R

O

U

G

H

P

R

O

X

Y

R

O

T

A

T

I

O

N

.

"

}

,

{

"

T

I

T

L

E

"

:

"

W

E

B

H

O

K

D

E

B

U

G

I

N

G

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

D

E

B

U

G

I

N

C

O

M

I

N

G

W

E

B

H

O

K

S

B

Y

R

O

U

T

I

N

G

T

E

S

T

C

A

L

S

T

H

R

O

U

G

H

D

I

F

E

R

E

N

T

P

R

O

X

Y

I

P

S

.

"

}

,

{

"

T

I

T

L

E

"

:

"

A

P

I

S

E

C

U

R

I

T

Y

T

E

S

T

I

N

G

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

T

E

S

T

A

P

I

S

E

C

U

R

I

T

Y

C

O

N

T

R

O

L

S

A

G

A

I

N

S

T

R

E

Q

U

E

S

T

S

F

R

O

M

V

A

R

I

O

U

S

I

P

R

A

N

G

E

S

A

N

D

L

O

C

A

T

I

O

N

S

.

"

}

]

Pro Tips

Use Postman environments to switch between proxy configurations (US, EU, Asia). Store GProxy credentials as environment variables, not hardcoded. Use Newman in CI pipelines with HTTP_PROXY env var. Test the same collection from multiple locations using different proxy configs.