HTTP
HTTP requests are the default request type in Thunder Client. Use them to test REST APIs, GraphQL endpoints, webhooks, and file uploads. You can add auth, environment variables, tests, and scripts to any request, then run it on its own or as part of a collection.
Send Your First Request
Create the request
In the sidebar, click New Request. A new request tab opens with GET selected.
Enter the method and URL
Choose a method and enter the URL, for example https://api.example.com/users. Supported methods are GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS, and PROPFIND.
Add request details
Use the request tabs to add query params, headers, auth, or a body. See Request Tabs below.
Send and review the response
Click Send. The status code, size, and time appear above the response. See Response below.
SEARCH or SUBSCRIBE, add them as a comma-separated list in the Custom Methods VS Code setting.Request Tabs
| Tab | What it does |
|---|---|
| Query | Add query parameters. They stay in sync with the URL. For {id}-style placeholders in the path, see Path Variables. |
| Headers | Add request headers. Use the Cookie header to send cookies. |
| Auth | Use Basic, Bearer, OAuth 2.0, NTLM, or AWS auth. See Authentication. |
| Body | Choose a body type. See Body Types below. |
| Tests | Check the status, headers, body, and more without writing code. See Tests. |
| Pre Run | Run pre-requests and scripts before the request is sent. |
Variables
Use {{variable}} to insert environment variables in the URL, query params, headers, auth, and body. They are resolved when you click Send, so the same request works against local, staging, and production.
{{baseUrl}}/users/{{userId}}Body Types
| Type | Content-Type | Use it for |
|---|---|---|
| JSON | application/json | Most REST APIs. Click Format to tidy the JSON. |
| XML | application/xml | SOAP and XML APIs. |
| Text | text/plain | Plain text payloads. |
| Form | multipart/form-data | Text fields and file uploads. See Form Content Type to set a type per field. |
| Form-encode | application/x-www-form-urlencoded | HTML-style form submissions and OAuth token endpoints. |
| GraphQL | application/json | GraphQL queries and mutations. See GraphQL below. |
| Binary | — | Sending a single file as the raw request body. Set the Content-Type header to match the file. |
GraphQL
Select GraphQL
Set the method, usually POST, enter the GraphQL endpoint, then open the Body tab and select GraphQL.
Write the query
Write the query or mutation in Query, and its variables as JSON in Variables.
query GetUser($id: ID!) {
user(id: $id) {
name
email
}
}{ "id": "42" }Send
Click Send. Thunder Client sends the query and variables as a JSON body.
Response
The status code, response size, and time are shown above the response.
| Tab | What it shows |
|---|---|
| Response | The response body with syntax highlighting. Use the menu to Save to File, Open in Code, toggle Word Wrap, or Collapse All / Expand All. XML responses can be converted to JSON. |
| Headers | The response headers. |
| Cookies | Cookies set by the server. |
| Results | Pass and fail results from the Tests tab. |
| Docs | Documentation for the request. |
To turn the request into code for your app, click the </> icon. See Code Snippet.
HTTP/2
Requests use HTTP/1.1 by default. To use HTTP/2, set the HTTP Version VS Code setting to HTTP/2. See Settings and Shortcuts.
Use with AI Assistants
AI assistants such as Claude Code, GitHub Copilot, and Cursor can create, update, and run HTTP requests through the Thunder Client MCP server. See MCP Server to set it up, and Tools for what it can do.
Related
- Import requests from cURL, Postman, OpenAPI, and more.
- Collection Runner to run many requests in order.
- Request Chaining to pass values from one response to the next request.