Skip to main content
Parameters and request bodies allow you to send data with your API requests. This guide covers query parameters, path variables, and different request body formats.

​
Path Variables

Path variables allow you to define dynamic segments in your API URL using the :variableName syntax. This is useful for RESTful APIs where resource identifiers are part of the URL path. For example, if your API endpoint is: 
https://api.example.com/users/:userId/posts/:postId
Requestly automatically detects the path variables (:userId and :postId) from the URL and displays them in the Params tab under Path Variables. You can then set values for each variable:
KeyValueDescription
userId123The user’s unique identifier
postId456The post’s unique identifier
When you send the request, Requestly compiles the URL with your provided values: 
https://api.example.com/users/123/posts/456
Path variables are automatically extracted from your URL. Simply type a URL with :variableName segments, and they’ll appear in the Path Variables table for you to fill in.

​
Query Parameters

In the Query Params section, you can add query parameters as key-value pairs to send extra information with the URL. To add more parameters, click on the + Add More button. Each query parameter consists of:
  • Key: The parameter name
  • Value: The parameter value
  • Type: An enum to enforce the value type
  • Description (optional): Internal documentation explaining the purpose of the parameter
For example:
  • Adding uid=123 to https://app.requestly.io/echo results in: https://app.requestly.io/echo?uid=123
The checkboxes next to each parameter let you include or exclude them without deleting them. For instance, if you uncheck a parameter, the final URL will not include it.

​
Bulk Edit Query Parameters

You can also manage query parameters using Bulk Edit. This allows you to add or update multiple parameters at once in a key:value format.
  • Add one parameter per line
  • Separate keys and values using a colon :
  • Prefix any line with // to disable that parameter
Bulk Edit is useful when working with a large number of query parameters or when making quick mass updates. Example: 
page:1
limit:50
sort:desc
// filter:active

​
Request Body

For POST, PUT, or PATCH requests, use the Body tab to send data to the server. Requestly supports multiple body formats to accommodate different API requirements.

​
Supported Body Types

Send raw data as plain text or structured JSON.When to use:
  • Sending JSON data to REST APIs
  • Posting XML or plain text
  • Sending custom formatted data
You can select the language format:
  • JSON – for structured data like API payloads
  • Text – for plain string or unstructured data
  • XML – for XML-based APIs
  • HTML – for HTML content
Example JSON:
{
  "name": "John Doe",
  "email": "[email protected]",
  "age": 30,
  "active": true
}

​
Autogenerated Headers

Requestly will automatically add certain headers to your requests based on your request body selections. When you add a request body, Requestly automatically sets the appropriate Content-Type header:
Body TypeContent-Type Header
RAW (JSON)application/json
RAW (Text)text/plain
RAW (XML)application/xml
x-www-form-urlencodedapplication/x-www-form-urlencoded
multipart/form-datamultipart/form-data
You can view and override the autogenerated headers in the Headers tab. These headers are automatically managed by Requestly to ensure your requests are properly formatted.

​
What’s Next?

Configure Headers

Add authentication and custom headers to your requests

Add Authorization

Set up API authentication methods

Use Variables

Make your requests dynamic with variables