> ## Documentation Index
> Fetch the complete documentation index at: https://bruno-a6972042-docs-timeline-scripts.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating a Request

Bruno makes it easy to work with various API protocols - whether you're building RESTful services with HTTP, designing GraphQL APIs, or converting cURL commands into reusable requests. With support for all standard HTTP methods (GET, POST, PUT, DELETE, etc.), you can create, test, and manage your API requests efficiently.

Let's walk through how to create your first request:

## Create a New Request in Bruno

1. Go to your Collection, and click on the `···` button.
2. Select `New Request` in the dropdown menu.

<img src="https://mintcdn.com/bruno-a6972042-docs-timeline-scripts/AyYH5GBP7A99LBWR/v2/images/screenshots/get-started/bruno-basics/create_request/1-create-new-request.webp?fit=max&auto=format&n=AyYH5GBP7A99LBWR&q=85&s=db6931736717e60ea89487e12100d674" alt="create request dialog" width="2622" height="1374" data-path="v2/images/screenshots/get-started/bruno-basics/create_request/1-create-new-request.webp" />

3. In the dialog that appears, choose:
   * Request Type (HTTP, GraphQL, or from cURL)
   * Request Name
   * HTTP Method (GET, POST, PUT, etc.)
   * URL

<img src="https://mintcdn.com/bruno-a6972042-docs-timeline-scripts/AyYH5GBP7A99LBWR/v2/images/screenshots/get-started/bruno-basics/create_request/2-create-request.webp?fit=max&auto=format&n=AyYH5GBP7A99LBWR&q=85&s=d930a9802cf7d0c839be025a27c1f8a4" alt="create-new-request" width="2622" height="1374" data-path="v2/images/screenshots/get-started/bruno-basics/create_request/2-create-request.webp" />

4. Click `Create` to finish.

You have successfully created your first request in Bruno! Feel free to add headers, query parameters, and a request body to your request, or play around with the other options available.

## Custom Request Filenames

<Info>
  Starting with [Bruno v1.40.0 <strong><sup>↗</sup></strong>](https://www.usebruno.com/downloads), you can
  now use special characters in request names and customize how they appear in
  the filesystem.
</Info>

You can use any characters in your request names, including special characters like `/`, `[`, `]`, `*`, etc. Bruno automatically handles filesystem compatibility by replacing unsupported characters with `-` in the filenames while preserving your original request name.

### To view or customize the filesystem name

1. Select **Show Filesystem Name.**

<img src="https://mintcdn.com/bruno-a6972042-docs-timeline-scripts/AyYH5GBP7A99LBWR/v2/images/screenshots/get-started/bruno-basics/create_request/3-file-system-option.webp?fit=max&auto=format&n=AyYH5GBP7A99LBWR&q=85&s=5cbeaa44bf7b518155c925a93a1a592e" alt="file-system-name" width="2622" height="1374" data-path="v2/images/screenshots/get-started/bruno-basics/create_request/3-file-system-option.webp" />

2. You can now see how your request name is stored on the filesystem.

<img src="https://mintcdn.com/bruno-a6972042-docs-timeline-scripts/AyYH5GBP7A99LBWR/v2/images/screenshots/get-started/bruno-basics/create_request/4-file-name-special-char.webp?fit=max&auto=format&n=AyYH5GBP7A99LBWR&q=85&s=a27159c8830cf180ce27e8170ab67bb9" alt="file-system-name" width="2622" height="1374" data-path="v2/images/screenshots/get-started/bruno-basics/create_request/4-file-name-special-char.webp" />

3. (Optional) Click the edit icon to customize the filename while keeping your display name intact.

This feature gives you complete freedom in naming your requests while ensuring filesystem compatibility.
