Quick Start Guide
Get up and running with Request Man in 5 minutes
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.
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.
View Response
The response appears below with:
- Status code: 200 OK
- Response time (e.g., 245ms)
- Formatted JSON body
Sending a POST Request
Now let's send data to an API:
Change HTTP Method
Click the method dropdown (currently "GET") and select POST.
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!"
}
Send Request
Click "Send". You'll see your data echoed back in the response!
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").
Request Saved
Your request now appears in the collections sidebar! Click it anytime to reload it.
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.comapiKey=your_api_key_here
Use in Requests
In your URL or headers, use double curly braces:
URL: {{baseUrl}}/users
Header: X-API-Key: {{apiKey}}
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}}
Send Request
The Authorization header is automatically added!
Other Authentication Types
Request Man supports 7 authentication types:
- Bearer Token
- Basic Auth
- API Key
- OAuth 2.0 (Automatic token management!)
- OAuth 1.0
- Digest Auth
- AWS Signature
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}}
}
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.
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!
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;
});
Send Request
Tests run automatically after the response is received.
View Results
Check the "Test Results" tab to see which tests passed or failed.
Next Steps
Now that you know the basics, explore more features:
Collections
Organize requests in folders and nested collections
OAuth 2.0
Automatic token management and refresh
Cookie Jar
Manage cookies for session-based APIs
Code Generation
Export requests as code in multiple languages
Dashboard
View analytics and request statistics
Mock Server
Create mock API responses for testing
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.