New to Request Man? Follow this guide to send your first API request and explore key features!

Your First API Request

Launch Request Man

Open the Request Man application. You'll see the main interface with a collections sidebar on the left and the request builder on the right.

Request Man - API Testing Tool Request Man COLLECTIONS 📁 My Workspace Welcome to Request Man! Start testing your APIs in seconds GET Enter request URL... Send Quick Actions 🚀 Send Request 📁 New Collection 📚 View Docs

Enter a URL

In the URL input field, type:

https://httpbin.org/get

This is a test API that echoes back your request.

Click Send

Click the blue "Send" button.

https://httpbin.org/get Send Request sent! ✓ Response received (200 OK)

View Response

The response appears below with:

  • Status code: 200 OK
  • Response time (e.g., 245ms)
  • Formatted JSON body
Response 200 OK 245 ms 1.5 KB Body Headers Cookies { "url": "https://httpbin.org/get", "headers": { "User-Agent": "Request-Man/1.0.0", "Accept": "*/*" }, "origin": "203.0.113.0" }
Congratulations! You just sent your first API request with Request Man! 🎉

Sending a POST Request

Now let's send data to an API:

Change HTTP Method

Click the method dropdown (currently "GET") and select POST.

GET ▼ POST GET POST PUT Click

Enter URL

https://httpbin.org/post

Add Header

Click the "Headers" tab below the URL.

Add:

  • Key: Content-Type
  • Value: application/json

Add Body

Click the "Body" tab.

Select "JSON" and enter:

{
  "name": "John Doe",
  "email": "john@example.com",
  "message": "Hello from Request Man!"
}
Body JSON { "name": "John Doe", "email": "john@example.com", "message": "Hello from Request Man!" }

Send Request

Click "Send". You'll see your data echoed back in the response!

Send Sending... 200 OK { "data": { "name": "John Doe", ... } }

Saving to a Collection

Organize your requests in collections:

Click Save Button

After configuring your request, click the "Save" button next to Send.

Name Your Request

Enter a descriptive name like "Get User Data" or "Create User".

Choose Collection

Select an existing collection or create a new one (e.g., "My API Tests").

Save Request Request Name Get User Data Save to Collection My API Tests ▼ Cancel Save

Request Saved

Your request now appears in the collections sidebar! Click it anytime to reload it.

Collections 📁 My API Tests ✓ Get User Data (NEW!) Create User Update User Click to load Request Loaded! All settings restored

Using Environment Variables

Variables make your requests reusable across environments:

Create Environment

Click "Environments" in the header.

Click "+ New Environment".

Add Variables

Name your environment (e.g., "Test") and add variables:

  • baseUrl = https://api.example.com
  • apiKey = your_api_key_here
Environment: Test VARIABLE INITIAL VALUE CURRENT VALUE baseUrl https://api.example.com https://api.example.com apiKey your_api_key_here your_api_key_here + Add Variable Active

Use in Requests

In your URL or headers, use double curly braces:

URL: {{baseUrl}}/users
Header: X-API-Key: {{apiKey}}
Before Resolution: {{baseUrl}} /users Resolved! After Resolution: https://api.example.com/users

Select Environment

Use the environment dropdown in the header to switch between Test, Production, etc.

Adding Authentication

Secure your API requests with authentication:

Bearer Token (Most Common)

Open Authorization Tab

Click the "Authorization" tab below the URL.

Select Type

Choose "Bearer Token" from the dropdown.

Enter Token

Paste your token or use a variable:

{{authToken}}
Authorization Type Bearer Token Token eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4g... {{authToken}}

Send Request

The Authorization header is automatically added!

Other Authentication Types

Request Man supports 7 authentication types:

Using Dynamic Variables

Generate random data automatically:

Use Built-in Variables

Request Man provides 9 dynamic variables:

Variable Generates
{{$guid}} Unique UUID
{{$timestamp}} Unix timestamp
{{$randomEmail}} Random email
{{$randomInt}} Random number
See all 9 variables →

Example Usage

POST {{baseUrl}}/users
Content-Type: application/json

{
  "id": "{{$guid}}",
  "email": "{{$randomEmail}}",
  "timestamp": {{$timestamp}}
}
{ "id": "a1b2c3d4-e5f6-7890" "f9e8d7c6-b5a4-3210" "7654fedc-ba98-0123" , "email": "john.doe@email.com" "jane.smith@test.io" "alex.wilson@demo.com" , "timestamp": 1699876543 1699876789 1699877021 } ✨ NEW VALUES! Each request generates fresh random values

Fresh Every Time

Each request generates new values automatically!

Running a Collection

Execute multiple requests in sequence:

Open Collection Runner

Click "Collection Runner" in the top tabs.

Select Collection

Choose a collection from your sidebar.

Collection Runner Select Collection 📁 My API Tests (5 requests) Configuration Environment: Test Environment Iterations: 1 Requests (5) ✓ GET /users ✓ POST /users ✓ GET /users/:id ▶ Run Collection

Configure Run

  • Environment: Select environment
  • Iterations: Number of times to run (default: 1)
  • Delay: Time between requests (ms)

Run Collection

Click "▶️ Run Collection".

Watch requests execute and view results!

Running... ✓ Complete! 5/5 ✓ GET /users - 200 OK (245ms) ✓ POST /users - 201 Created (312ms) ✓ GET /users/123 - 200 OK (189ms) All tests passed! 15/15 assertions successful

Adding Test Scripts

Validate responses automatically:

Open Tests Tab

In the request builder, click the "Tests" tab.

Write Test Assertions

// Test status code
rm.test("Status is 200", function () {
    rm.expect(rm.response.code).to.equal(200);
});

// Test response body
const jsonData = rm.response.json();
rm.test("Has user ID", function () {
    rm.expect(jsonData.id).to.exist;
});
Tests // Test status code rm.test( "Status is 200" , () => { rm.expect(rm.response.code).to.equal( 200 ); }); // Test response body const jsonData = rm.response.json(); rm.test( "Has user ID" , () => { rm.expect(jsonData.id).to.exist; }); 1 2 3 4 6 7 8 9 10

Send Request

Tests run automatically after the response is received.

View Results

Check the "Test Results" tab to see which tests passed or failed.

Test Results ✓ All Tests Passed 2 passed • 0 failed • 189ms Status is 200 45ms Has user ID 23ms

Learn more about scripting →

Next Steps

Now that you know the basics, explore more features:

Useful Keyboard Shortcuts

Action Windows/Linux macOS
Send Request Ctrl + Enter Cmd + Enter
Save Request Ctrl + S Cmd + S
New Request Ctrl + N Cmd + N
Open Console Ctrl + ` Cmd + `
Search Ctrl + F Cmd + F

Quick Tips

💾 Save Often

Save your requests to collections so you don't lose your work.

📁 Organize Well

Use descriptive names for collections and requests.

🌍 Use Environments

Set up separate environments for dev, staging, and production.

✅ Add Tests

Write test scripts to validate responses automatically.

🔍 Check Console

View detailed logs and debug information in the console.

📝 Use Comments

Add descriptions to requests for future reference.