Request Builder

Overview

The Request Builder is the heart of Request Man, allowing you to construct and send HTTP requests with full control over every aspect of the request. Whether you're testing a simple GET endpoint or configuring complex POST requests with authentication, the Request Builder has you covered.

HTTP Methods

Request Man supports all standard HTTP methods:

URL Configuration

Basic URL Input

Enter your API endpoint in the URL field. Request Man supports:

• HTTP and HTTPS protocols
• IPv4 and IPv6 addresses
• Domain names with all TLDs
• Ports (e.g., http://localhost:3000)
• Path parameters (e.g., /users/:id)

Variable Substitution

Use double curly braces to insert variables:

{{baseUrl}}/api/users/{{userId}}

Variables can come from:

• Environment variables
• Collection variables
• Global variables
• Dynamic variables (e.g., {{$timestamp}})

Query Parameters

Adding Parameters

The Params tab provides a visual interface for query parameters:

Bulk Edit

Click "Bulk Edit" to enter parameters as plain text:

page=1
limit=20
sort=name
order=asc

Request Headers

Common Headers

Request Man provides auto-suggestions for common headers:

• Content-Type - Specify request body format
• Accept - Preferred response format
• Authorization - Authentication credentials
• User-Agent - Client identification
• X-API-Key - API key authentication

Adding Custom Headers

Authorization

The Authorization tab provides a dedicated interface for authentication. Request Man supports 7 authentication types:

Request Body

Body Types

Request Man supports multiple body formats:

1. None

No request body (used for GET, DELETE, HEAD, OPTIONS)

2. JSON

Raw JSON data with syntax highlighting and validation:

{
  "name": "John Doe",
  "email": "john@example.com",
  "age": 30,
  "active": true
}

3. Form Data (URL Encoded)

Key-value pairs for form submissions:

4. Raw Text

Plain text, XML, or any other text-based format

5. Binary/File Upload

Upload files directly from your system

Variable Substitution in Body

Use variables in request body for dynamic data:

{
  "userId": "{{userId}}",
  "timestamp": {{$timestamp}},
  "email": "{{$randomEmail}}"
}

Pre-request Scripts

Execute JavaScript before sending the request:

// Set dynamic timestamp
rm.environment.set("timestamp", Date.now());

// Generate random token
const token = "Bearer_" + Math.random().toString(36).substring(7);
rm.environment.set("authToken", token);

// Log information
console.log("Request will be sent at:", new Date().toISOString());

Learn more about scripts →

Test Scripts

Validate responses with 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("User ID exists", function () {
    rm.expect(jsonData.id).to.exist;
});

// Test response time
rm.test("Response time < 500ms", function () {
    rm.expect(rm.response.responseTime).to.be.below(500);
});

Learn more about testing →

Sending Requests

Response Viewer

Response Tabs

1. Body Tab

View formatted response body with syntax highlighting:

2. Headers Tab

View all response headers:

3. Raw Tab

View the complete raw HTTP response

4. Test Results Tab

See test script results and assertions:

Status Code Display

Response status is color-coded:

• 2xx - Success (green)
• 3xx - Redirection (blue)
• 4xx - Client Error (yellow)
• 5xx - Server Error (red)

Saving Requests

Save to Collection

Tips & Best Practices