# GraphQL Client

> Build GraphQL operations and run them through Postman Cloud Agent.

GraphQL Client is a signed-out GraphQL client with schema introspection and a visual query builder.

Also: online graphql client, graphql query builder, graphql playground, graphql introspection, graphql subscription client.

## What it does

Enter a GraphQL endpoint to load its schema, build the schema, send queries using Postman, and inspect query or subscription responses.

## When to use it

- You want to explore an unfamiliar GraphQL schema.
- You want to build a query without writing every field by hand.
- You need to inspect GraphQL query, mutation, or subscription responses.

## What you give it

| Input | Meaning |
| --- | --- |
| GraphQL endpoint | The publicly accessible HTTP, HTTPS, WS, or WSS endpoint to query. |
| GraphQL query | A query, mutation, or subscription built visually or edited as GraphQL source. |
| Request configuration | Authorization, custom headers, and a schema. |

## What you get back

| Output | Meaning |
| --- | --- |
| GraphQL response | A formatted JSON response with HTTP status, timing, size, and headers. |
| Subscription timeline | Live GraphQL subscription messages and WebSocket lifecycle events. |
| Schema-powered query | A GraphQL operation generated from selected schema fields and arguments. |

## Key terms

- **GraphQL introspection** — a standard query that describes an endpoint’s types, fields, and arguments.
- **Cloud Agent** — Postman infrastructure that executes requests for you.

## Questions

### Can the playground run GraphQL subscriptions?

Yes. Subscription operations are supported and display messages as a live timeline.

### Can I import a GraphQL schema?

Yes. Import SDL or introspection JSON from a local file or a publicly accessible URL.

### Does the playground resolve variables?

No. It does not load workspace, collection, environment, history, or variable state.


## Privacy

Endpoint, query, headers, and authorization data are sent to Postman Cloud Agent for execution. The playground does not load workspace or account data.

## Links

- [Use the tool](https://www.postman.com/tools/graphql-client) — the interactive version of this page.
- [Postman Tools](https://www.postman.com/tools) — every free tool in this set.
- [Guide to GraphQL requests](https://learning.postman.com/docs/sending-requests/graphql/graphql-overview/) — Postman documentation.