Announcing Postman’s new GraphQL client

Avatar

We’re excited to announce that Postman’s new GraphQL client is in open beta! Applying our learnings from building support for WebSockets, Socket.IO, and gRPC, we revisited the GraphQL client and built a development environment that is both simple and powerful. With the new GraphQL client, we’re ready to help GraphQL grow and are committed to its ongoing success.

Download the Postman GraphQL Client

Growth of GraphQL

GraphQL is experiencing incredible growth. Its popularity has been gaining year over year, with it being the fourth most popular API technology in our 2022 State of the API Report. However, GraphQL can often be a maze of data; as companies grow, their data becomes more challenging to explore.

We set out to simplify the schema explorer and lower the learning curve, making testing and debugging your queries, mutations, and subscriptions easier. Our goal was to create a client that felt welcoming to all the new GraphQL users while supporting GraphQL power users’ workflows.

Schema explorer

There are consumers and producers in the API lifecycle. As a consumer, the power of introspection in the new GraphQL client allows you to explore your schema easily and quickly. Enter your GraphQL API URL, and the client automatically introspects your schema. You can quickly build a query, mutation, or subscription to get the data you need without additional overhead.

Create a new GraphQL query with URL introspection
Create a new GraphQL query with URL introspection

Additionally, as a producer you can load your GraphQL schema from an API definition or a local file, write test scripts (before query and after response), and collaborate with your team to ensure your GraphQL API is powerful and provides the necessary data.

Quickly load a GraphQL schema
Quickly load a GraphQL schema

Query Builder

As I mentioned above, a goal we set out to accomplish was to make it easier to learn GraphQL. The query builder correctly writes code-ready queries, mutations, and subscriptions as you select fields in the schema explorer. If you manually write your queries, the new client provides readable errors to help you keep your queries clean.

Write GraphQL queries, mutations, subscriptions in the Query Builder
Write GraphQL queries, mutations, and subscriptions in the query builder

Here’s a pro tip: you can use the “split pane” view to see the schema explorer, query builder, and response side by side.

Use split screen to show the schema explorer, query builder and response side by side
Use split screen to show the schema explorer, query builder, and response side by side

Getting started

To get started, update the Postman app to the latest version (10.10 as of this writing). If you use the browser, update your Postman desktop agent. Our GraphQL Echo Service is an excellent introduction to the new GraphQL client, and our handy “Getting Started Guide” includes a list of public GraphQL APIs to explore along with updated documentation. We also have a thriving community around GraphQL and the GraphQL specification.

What’s next for GraphQL?

As with any beta, we want to hear from you! The new GraphQL client is only as good as the feedback we receive from the fantastic GraphQL community. Last year we joined the GraphQL Foundation to support the community’s growth efforts, and we will continue to bring the latest innovations to the Postman GraphQL client, such as the Oct. 2021 GraphQL Spec, closer to our users.

You can submit feedback and feature requests in our GitHub issues.

Try Postman now

What do you think about this feature? Tell us in a comment below. You can also give product feedback through our Community forum and GitHub repository.

Comment

Your email address will not be published. Required fields are marked *


This site uses Akismet to reduce spam. Learn how your comment data is processed.

4 thoughts on “Announcing Postman’s new GraphQL client

  • Avatar

    In the postman desktop client, We cannot select the checkbox in the GraphQL query builder. The checkbox is automatically getting cleared.

    • Avatar

      There was a known issue with Windows users that was causing the checkboxes to be cleared. This bug has since been fixed. If this is not your case, please email me directly and we can work to solve this issue.

  • Avatar

    It looks like the pull request feature doesn’t work for graphql collections yet…

  • Avatar

    It looks like the pull request feature doesn’t work for graphql collections yet…