Setup and use the Postman GraphQL User Interface
Author:
Fluent Commerce
Changed on:
22 May 2025
Key Points
- Postman has a special client for GraphQL requests called the GraphQL client.
- The GraphQL client has features that allow you to create and execute GraphQL requests more efficiently.
- It automatically fetches the schema of a GraphQL API and uses introspection to show you the available data fields.
- You can explore the data fields of a GraphQL API and construct queries by selecting fields or entering code in an editor.

Prerequisites
Steps
Step 1. Create a new request

Step 2. Select a new Client

Step 3. Set the API GraphQL endpoint
endpoint: `{{fluentApiHost}}/graphql`

Step 4. Set the token value
Select “Bearer tokenˮ as Auth type, then set the variable with the token value: `{{retailer_token}}`

Step 5. Use GraphQL Introspection
Save and click into Introspection, then load the schema from the Fluent Commerce OMS or retailer linked to the bearer token.

Step 6. Look for a query or mutation
To look for a query or mutation:
- Use the checkboxes to add input and fetch attributes to compose the GraphQL request.
- Then hit the blue 'query' button to run the request.
