Add a New Bruno API Request

In this tutorial, you will learn how to add a new API request to a Bruno collection. To add a new API request in Bruno, you can follow these simple steps:

Open Bruno

• Launch the Bruno API Client on your system.

• Open the collection where you want to add the new request.

Add a New Request

• Right-click on the collection or folder.

• Select “New Request”.

• Enter a name for your request (e.g., Get Users).

Provide the following details:

• Request name: a short, descriptive title (e.g., Create User).
• HTTP method: GET, POST, PUT, DELETE, etc.
• URL: use variables where helpful (e.g., {{BASE_URL}}/users).
• Headers: common headers like Content-Type: application/json and authorization headers (use variable references for tokens).
• Body: for POST/PUT requests, paste an example JSON payload or form data.

 

Configure authentication

In the request settings or collection settings, set the authentication type (API key, Bearer token, Basic Auth, OAuth). Reference your environment variables so credentials aren’t hard-coded into individual requests.

Group and document requests

Create folders inside the collection to group related endpoints (for example /users and /auth). Add short descriptions or usage notes to requests so teammates understand purpose and required inputs.

Test requests and save responses

Run each request using test credentials. Inspect the response status, headers, and body. Save or snapshot successful example responses if Bruno supports that — this helps with debugging and documentation.