---
title: "Using Postman with OAuth and Machine Credentials"
slug: "using-postman-with-oauth-and-machine-credentials"
updated: 2025-12-17T11:38:16Z
published: 2025-12-17T11:38:16Z
canonical: "help.hyperscience.ai/using-postman-with-oauth-and-machine-credentials"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.hyperscience.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Using Postman with OAuth and Machine Credentials

This article explains how to create and utilize OAuth 2.0 Machine Credentials from Hypercell to access the API using Postman.

Postman is a popular API development platform that helps developers test, build, and modify APIs. It allows users to create and send HTTP requests to web services and examine the responses.

1. In your Hyperscience instance, create machine credentials by going to **Users** > **Machine Credentials** and following the steps in [Managing Machine Credentials](/v42/docs/managing-machine-credentials#create-machine-credentials). ![](https://cdn.us.document360.io/87894cef-4958-4f3f-be6f-b75a78c82548/Images/Documentation/PostmanCreateCredential.png)
2. In Postman, create an HTTP request for an API endpoint.

![](https://cdn.us.document360.io/87894cef-4958-4f3f-be6f-b75a78c82548/Images/Documentation/PostmanCreateHTTPRequest.png)
  - For more information about our API endpoints, see our [API documentation](http://docs.hyperscience.com/).
3. Under **Authorization**, select **OAuth 2.0**. ![](https://cdn.us.document360.io/87894cef-4958-4f3f-be6f-b75a78c82548/Images/Documentation/PostmanAuthorization(1).png)
4. In the **Configure New Token** section, change **Grant Type** to **Client Credentials**. ![](https://cdn.us.document360.io/87894cef-4958-4f3f-be6f-b75a78c82548/Images/Documentation/PostmanConfigureNewToken(1).png)
5. Paste the **Client ID** and **Client Secret** from your Hyperscience instance into their respective fields in the **Configure New Token** section.
6. In the **Access Token URL** field, enter the URL of your Hypercell instance followed by `/api/v5/local_identity_provider/oauth2/token` (e.g., `https://example.com/api/v5/local_identity_provider/oauth2/token`). ![](https://cdn.us.document360.io/87894cef-4958-4f3f-be6f-b75a78c82548/Images/Documentation/PostmanConfigureNewTokenContinued.png)
7. (SaaS deployments only) Under **Headers**, add a header named `HyperscienceLocalIdentityProvider` with a value of `1`.
8. Click **Get New Access Token**.
9. In the **Manage Access Tokens** dialog box, click **Use Token**. ![](https://cdn.us.document360.io/87894cef-4958-4f3f-be6f-b75a78c82548/Images/Documentation/PostmanManageAccessTokens.png)

Note that a temporary access token (`eyJhbG…`) has been populated in the **Current Token** section of the Postman HTTP request. ![](https://cdn.us.document360.io/87894cef-4958-4f3f-be6f-b75a78c82548/Images/Documentation/PostmanCurrentToken.png)
10. Click **Send** in the upper-right hand corner.

You should see a successful (`200 OK`) HTTP response in Postman. ![](https://cdn.us.document360.io/87894cef-4958-4f3f-be6f-b75a78c82548/Images/Documentation/Postman200OK.png)