# Using Postman with OAuth and Machine Credentials

- Updated on Dec 17, 2025
- Published on Dec 16, 2025

- 1 minute(s) read

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.

## Steps to Use Postman with OAuth 2.0 Machine Credentials

01. In your Hyperscience instance, create machine credentials by going to **Users** \> **Machine Credentials** and following the steps in [Managing Machine Credentials](https://help.hyperscience.ai/v42/docs/managing-machine-credentials#create-machine-credentials).

02. In Postman, create an HTTP request for an API endpoint.

- For more information about our API endpoints, see our [API documentation (opens in new tab)](http://docs.hyperscience.com/).

03. Under **Authorization**, select **OAuth 2.0**.

.png?sv=2026-02-06&spr=https&st=2026-07-27T09%3A23%3A33Z&se=2026-07-27T09%3A34%3A33Z&sr=c&sp=r&sig=EnCoNbq5aQSZMkSyv8vGIlJqx8VpTQPeWRO%2B%2BpXP%2FPI%3D)

04. In the **Configure New Token** section, change **Grant Type** to **Client Credentials**.

.png?sv=2026-02-06&spr=https&st=2026-07-27T09%3A23%3A33Z&se=2026-07-27T09%3A34%3A33Z&sr=c&sp=r&sig=EnCoNbq5aQSZMkSyv8vGIlJqx8VpTQPeWRO%2B%2BpXP%2FPI%3D)

05. Paste the **Client ID** and **Client Secret** from your Hyperscience instance into their respective fields in the **Configure New Token** section.

06. 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`).

07. (SaaS deployments only) Under **Headers**, add a header named `HyperscienceLocalIdentityProvider` with a value of `1`.

08. Click **Get New Access Token**.

09. In the **Manage Access Tokens** dialog box, click **Use Token**.

Note that a temporary access token (`eyJhbG…`) has been populated in the **Current Token** section of the Postman HTTP request.

10. Click **Send** in the upper-right hand corner.

You should see a successful (`200 OK`) HTTP response in Postman.
