Skip to Content

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.

To use other methods, such as SEARCH or SUBSCRIBE, add them as a comma-separated list in the Custom Methods VS Code setting.

Request Tabs

TabWhat it does
QueryAdd query parameters. They stay in sync with the URL. For {id}-style placeholders in the path, see Path Variables.
HeadersAdd request headers. Use the Cookie header to send cookies.
AuthUse Basic, Bearer, OAuth 2.0, NTLM, or AWS auth. See Authentication.
BodyChoose a body type. See Body Types below.
TestsCheck the status, headers, body, and more without writing code. See Tests.
Pre RunRun 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

TypeContent-TypeUse it for
JSONapplication/jsonMost REST APIs. Click Format to tidy the JSON.
XMLapplication/xmlSOAP and XML APIs.
Texttext/plainPlain text payloads.
Formmultipart/form-dataText fields and file uploads. See Form Content Type to set a type per field.
Form-encodeapplication/x-www-form-urlencodedHTML-style form submissions and OAuth token endpoints.
GraphQLapplication/jsonGraphQL 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.

TabWhat it shows
ResponseThe 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.
HeadersThe response headers.
CookiesCookies set by the server.
ResultsPass and fail results from the Tests tab.
DocsDocumentation 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.

Last updated on