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

# gRPC Request

Bruno provides comprehensive support for gRPC requests, enabling you to test and interact with gRPC services directly from the interface. With Bruno's gRPC support, you can:

* **Add Proto files** for enhanced IntelliSense and method discovery
* **Use Server Reflection** as an alternative to Proto files for automatic method suggestions
* **Call server methods** with full parameter support and type validation
* **Test real-time streaming APIs** including unary, server streaming, client streaming, and bidirectional streaming

## gRPC Interface

Bruno gRPC interface provides an intuitive way to interact with gRPC services. The interface automatically adapts based on whether you're using Proto files or Server Reflection.

<img src="https://mintcdn.com/bruno-a6972042-mintlify-8b44a422/tl14CESLOGi4iXZ-/images/screenshots/send-request/grpc/1-grpc-interface.webp?fit=max&auto=format&n=tl14CESLOGi4iXZ-&q=85&s=b0259e8bec011aceeda059ddf41dc04c" alt="gRPC Interface" width="2660" height="1444" data-path="images/screenshots/send-request/grpc/1-grpc-interface.webp" />

## Creating a gRPC Request

### Step 1: Create a gRPC Request

1. Open the collection context menu and select **New Request** from the dropdown

<img src="https://mintcdn.com/bruno-a6972042-mintlify-8b44a422/CAk0Q5WL0rOLuN3Q/images/screenshots/get-started/bruno-basics/create_request/1-create-new-request.webp?fit=max&auto=format&n=CAk0Q5WL0rOLuN3Q&q=85&s=05da134122e8b3ebe59e0234937053d0" alt="create request dialog" width="2480" height="1046" data-path="images/screenshots/get-started/bruno-basics/create_request/1-create-new-request.webp" />

2. Select **gRPC** as your request type
3. Enter the **service endpoint** in the URL field (e.g., `https://grpcb.in/`)

<img src="https://mintcdn.com/bruno-a6972042-mintlify-8b44a422/tl14CESLOGi4iXZ-/images/screenshots/send-request/grpc/2-create-grpc-req.webp?fit=max&auto=format&n=tl14CESLOGi4iXZ-&q=85&s=0057f78721aa43944062883b032b7295" alt="Create gRPC Request" width="2472" height="968" data-path="images/screenshots/send-request/grpc/2-create-grpc-req.webp" />

### Step 2: Configure the Request

1. Click on **Reflection** and choose the **method** you want to call from the dropdown

<Warning>
  **Refresh**: The gRPC refresh feature caches server information in memory for better performance. If you're running a local gRPC server and make changes to your service definitions, click the **Refresh** button next to the **Using Reflection** toggle to reload the latest changes from your server.
</Warning>

2. Use the **search functionality** in the dropdown to quickly find your desired method by typing the method name

<img src="https://mintcdn.com/bruno-a6972042-mintlify-8b44a422/tl14CESLOGi4iXZ-/images/screenshots/send-request/grpc/3-select-method.webp?fit=max&auto=format&n=tl14CESLOGi4iXZ-&q=85&s=994fde4553bd90c971e58378500e544e" alt="Select Method" width="2472" height="1280" data-path="images/screenshots/send-request/grpc/3-select-method.webp" />

### Step 3: Send the Request

1. Add any **required inputs** in the message section (auto generate with **Auto Fill** button)

2. Click the **Send** button to execute your gRPC request.

<img src="https://mintcdn.com/bruno-a6972042-mintlify-8b44a422/tl14CESLOGi4iXZ-/images/screenshots/send-request/grpc/4-add-msg-receive-resp.webp?fit=max&auto=format&n=tl14CESLOGi4iXZ-&q=85&s=40c52bf4672ba466eb3ef88bb9153962" alt="Add Message and Receive Response" width="2472" height="850" data-path="images/screenshots/send-request/grpc/4-add-msg-receive-resp.webp" />

You'll see the response in the **Response** section with detailed information about the request execution.

## Adding metadata

gRPC uses metadata instead of HTTP headers. Use metadata to send key-value pairs such as access tokens or tenant identifiers with a request.

1. Open your gRPC request and select the **Metadata** tab in the request pane.
2. Click **Add Metadata** and enter the key and value.
3. Use the checkbox next to an entry to enable or disable it.

Metadata values support variable interpolation, so you can reference environment or collection variables like `{{token}}`.

For authentication methods such as Basic, Bearer, or API key, use the **Auth** tab instead of adding metadata manually.

To learn about proto files, navigate to the [Adding Proto file section.](./grpc-proto)
