Requests

Insomnia supports sending requests via HTTP, gRPC, and GraphQL.

To learn how to repurpose parts of your request, see Environment Variables.

Send an HTTP request

Send an HTTP method request in a Document or Collection. The following instructions assume you’re starting with an empty Document or Collection.

In addition to standard HTTP methods, Insomnia supports Custom HTTP Methods.

1. In a Document, select the Debug tab, then New Request. In a Collection, select New Request.
2. In the New Request modal:
   1. Enter a request name.
   2. Select a method from the dropdown.
   3. Click Create.
3. Enter the API URL in the request URL input.
4. To add authentication, go to the Auth tab. Use the Auth dropdown to select your authentication method.
5. When you have entered your request URL and authentication, click Send.

See Request Options to customize your request.

Request Options

Modify any HTTP method or GraphQL request with the following options.

Option	Description
Body	Select a body type from the Body dropdown menu on the tab. Add content that you want to send in the body of the request.
Auth	The authentication for the request. Select an authentication type from the Auth dropdown menu on the tab.
Query	Add query parameters to your request URL. For example, ?page=1.
Header	Add a header to your request. For example, Content-Type: application/json.
Docs	The request description.

Custom HTTP Methods

Add your own custom HTTP methods through the New Request modal dropdown or the methods dropdown.

1. Click on Custom Method.
2. An HTTP Method modal will appear. Enter your method name.
3. Click Done.

To access existing custom methods, click on Custom Method in the methods dropdown.

Send a gRPC request

Send a gRPC method request in a Document or Collection. The following instructions assume you’re starting with an empty Document or Collection.

1. In a Document, select the Debug tab, then New Request. In a Collection, select New Request.
2. In the New Request modal:
   1. Enter a request name.
   2. Select gRPC from the dropdown.
   3. Click Create.
3. You’ll be taken to a Select Proto File modal.
4. Click Add Directory or Add Proto File.
5. Add your directory or upload your Proto File. Insomnia will automatically detect the streaming types and modify the first tab as such.
6. Enter your API URL and click Start.

See gRPC Request Options to customize your request.

gRPC Request Options

Modify any gRPC request with the following options.

Option	Description
Streaming Type Example: Unary	The body of the request. The tab displays the streaming type, auto-detected from the Proto File or directory. Streaming types are: Unary, Server Streaming, Client Streaming, and Bidirectional Streaming.
Headers	Add gRPC metadata to your request. For example, Content-Type: application/grpc.

Send a GraphQL request

Send a GraphQL method request in a Document or Collection. The following instructions assume you’re starting with an empty Document or Collection.

1. In a Document, select the Debug tab, then New Request. In a Collection, select New Request.
2. In the New Request modal:
   1. Enter a request name.
   2. Select POST from the dropdown.
   3. Another dropdown will appear to the right. Open it and select GraphQL Query.
   4. Click Create.
3. Enter the API URL in the request URL input.
4. In the GraphQL body tab, add you GraphQL schema.
5. To add authentication, go to the Auth tab. Use the Auth dropdown to select your authentication method.
6. When you have entered your request URL and authentication, click Start or Send.

See Request Options to customize your request.