# Using API Clients (/docs/management-api/api-clients)

Location: Management API > Using API Clients

This guide shows you how to configure popular API clients to work with the Management API using OAuth 2.0 authentication.

<a href="/docs/prisma-management-api.postman_collection.json" download="prisma-management-api.postman_collection.json">Download the Postman collection</a> to import all endpoints with OAuth2 auth pre-configured. Compatible with Postman, Yaak, Insomnia, and other clients that support the Postman Collection v2.1 format.

Postman [#postman]

Postman is a popular API client with testing, collaboration, and automation features for working with REST APIs.

Prerequisites [#prerequisites]

Before you begin, make sure you have:

* A [Prisma Console account](https://console.prisma.io/?utm_source=docs\&utm_medium=content\&utm_content=management-api)
* [Postman installed](https://www.postman.com/downloads/)

1. Create an OAuth2 Application [#1-create-an-oauth2-application]

First, you'll need to register an OAuth2 application in Prisma Console:

1. Navigate to [Prisma Console](https://console.prisma.io/?utm_source=docs\&utm_medium=content\&utm_content=management-api) and log in
2. Click the **🧩 Integrations** tab in the left sidebar
3. Under the "Published Applications" section, click **New Application**
4. Fill in your application details:
   * **Name**: Postman API Client
   * **Description**: Brief description of your application *(Optional)*
   * **Redirect URI**: `https://oauth.pstmn.io/v1/callback`
5. Click **Continue**
6. **Important**: Copy your Client ID and Client Secret immediately and store them securely

> [!NOTE]
> The redirect URI `https://oauth.pstmn.io/v1/callback` is Postman's default callback URL when using the "Authorize using browser" option.

2. Configure OAuth 2.0 in Postman [#2-configure-oauth-20-in-postman]

Now you'll set up authentication in Postman:

1. Open Postman and create a new HTTP request
2. Set the request method to **POST**
3. Set the URL to `https://api.prisma.io/v1/projects`
4. Navigate to the **Authorization** tab
5. Set **Auth Type** to **OAuth 2.0**
6. Under **Configure New Token**, enter the following values:

| Parameter            | Value                                |
| -------------------- | ------------------------------------ |
| Token Name           | Management API Token                 |
| Grant Type           | Authorization Code                   |
| Callback URL         | `https://oauth.pstmn.io/v1/callback` |
| Authorize in Browser | `true` *(checked)*                   |
| Auth URL             | `https://auth.prisma.io/authorize`   |
| Access Token URL     | `https://auth.prisma.io/token`       |
| Client ID            | `your-client-id`                     |
| Client Secret        | `your-client-secret`                 |
| Scope                | `workspace:admin`                    |

7. Click **Get New Access Token**
8. A browser window will open and have you complete the authorization flow
9. Return to Postman and click **Use Token** to attach it to your request
10. Verify that your new token appears under **Current Token** at the top of the Authorization tab

3. Make your first request [#3-make-your-first-request]

With authentication configured, you can now create a project:

1. In the request body, select **raw** and **JSON** format
2. Add the following JSON payload:

```json
{
  "name": "My Postman Database",
  "region": "us-east-1"
}
```

3. Click **Send**

You should receive a successful response confirming your project creation.

Insomnia [#insomnia]

Insomnia is an open-source API client with a clean interface for testing and debugging HTTP requests.

Prerequisites [#prerequisites-1]

Before you begin, make sure you have:

* A [Prisma Console account](https://console.prisma.io/?utm_source=docs\&utm_medium=content\&utm_content=management-api)
* [Insomnia installed](https://insomnia.rest/download/)

1. Create an OAuth2 Application [#1-create-an-oauth2-application-1]

First, you'll need to register an OAuth2 application in Prisma Console:

1. Navigate to [Prisma Console](https://console.prisma.io/?utm_source=docs\&utm_medium=content\&utm_content=management-api) and log in
2. Click the **🧩 Integrations** tab in the left sidebar
3. Under the "Published Applications" section, click **New Application**
4. Fill in your application details:
   * **Name**: Insomnia API Client
   * **Description**: Brief description of your application *(Optional)*
   * **Redirect URI**: `https://app.insomnia.rest/oauth/redirect`
5. Click **Continue**
6. **Important**: Copy your Client ID and Client Secret immediately and store them securely

> [!NOTE]
> Insomnia uses `https://app.insomnia.rest/oauth/redirect` as the default OAuth callback URL for local authentication flows.

2. Configure OAuth 2.0 in Insomnia [#2-configure-oauth-20-in-insomnia]

Now you'll set up authentication in Insomnia:

1. Open Insomnia and create a new HTTP request
2. Set the request method to **POST**
3. Set the URL to `https://api.prisma.io/v1/projects`
4. Navigate to the **Auth** tab
5. Set the authentication type to **OAuth 2.0**
6. Under **Configuration**, enter the following values:

| Parameter                        | Value                                      |
| -------------------------------- | ------------------------------------------ |
| Grant Type                       | Authorization Code                         |
| Authorization URL                | `https://auth.prisma.io/authorize`         |
| Access Token URL                 | `https://auth.prisma.io/token`             |
| Client ID                        | `your-client-id`                           |
| Client Secret                    | `your-client-secret`                       |
| Redirect URL                     | `https://app.insomnia.rest/oauth/redirect` |
| Scope *(Under Advanced Options)* | `workspace:admin`                          |

7. Click **Fetch Tokens**
8. A browser window will open and have you complete the authorization flow
9. Return to Insomnia and verify that the access token has been retrieved
10. The token will be automatically attached to your requests

3. Make your first request [#3-make-your-first-request-1]

With authentication configured, you can now create a project:

1. Navigate to the **Body** tab and select **JSON** format
2. Add the following JSON payload:

```json
{
  "name": "My Insomnia Database",
  "region": "us-east-1"
}
```

3. Click **Send**

You should receive a successful response confirming your project creation.

Yaak [#yaak]

Yaak is a lightweight, open-source, and offline API client that works with Git.

Prerequisites [#prerequisites-2]

Before you begin, make sure you have:

* A [Prisma Console account](https://console.prisma.io/?utm_source=docs\&utm_medium=content\&utm_content=management-api)
* [Yaak installed](https://yaak.app)

1. Create an OAuth2 Application [#1-create-an-oauth2-application-2]

First, you'll need to register an OAuth2 application in Prisma Console:

1. Navigate to [Prisma Console](https://console.prisma.io/?utm_source=docs\&utm_medium=content\&utm_content=management-api) and log in
2. Click the **🧩 Integrations** tab in the left sidebar
3. Under the "Published Applications" section, click **New Application**
4. Fill in your application details:
   * **Name**: Yaak API Client
   * **Description**: Brief description of your application *(Optional)*
   * **Redirect URI**: `https://devnull.yaak.app/callback`
5. Click **Continue**
6. **Important**: Copy your Client ID and Client Secret immediately and store them securely

> [!NOTE]
> The redirect URI can be any valid URL. Yaak intercepts the OAuth callback regardless of the redirect URI, as long as it matches what's registered with the provider.

2. Configure OAuth 2.0 in Yaak [#2-configure-oauth-20-in-yaak]

Now you'll set up authentication in Yaak:

1. Open Yaak and create a new HTTP request
2. Set the request method to **POST**
3. Set the URL to `https://api.prisma.io/v1/projects`
4. Navigate to the **Auth** tab
5. Set the authentication type to **OAuth 2.0**
6. Enter the following values:

| Parameter         | Value                               |
| ----------------- | ----------------------------------- |
| Grant Type        | Authorization Code                  |
| Authorization URL | `https://auth.prisma.io/authorize`  |
| Token URL         | `https://auth.prisma.io/token`      |
| Client ID         | `your-client-id`                    |
| Client Secret     | `your-client-secret`                |
| Redirect URL      | `https://devnull.yaak.app/callback` |
| Scope             | `workspace:admin`                   |

7. Click **Get Token**
8. A browser window will open and have you complete the authorization flow
9. Return to Yaak and verify that the access token has been retrieved
10. The token will be automatically attached to your requests

3. Make your first request [#3-make-your-first-request-2]

With authentication configured, you can now create a project:

1. Navigate to the **Body** tab and select **JSON** format
2. Add the following JSON payload:

```json
{
  "name": "My Yaak Database",
  "region": "us-east-1"
}
```

3. Click **Send**

You should receive a successful response confirming your project creation.

## Related pages

- [`Authentication`](https://www.prisma.io/docs/management-api/authentication): Learn how to authenticate with the Prisma Management API using service tokens or OAuth 2.0
- [`Getting Started`](https://www.prisma.io/docs/management-api/getting-started): Get started with the Prisma Management API by creating your first project and database
- [`Partner Integration`](https://www.prisma.io/docs/management-api/partner-integration): Build partner integrations that provision and transfer Prisma Postgres databases to users
- [`SDK`](https://www.prisma.io/docs/management-api/sdk): A TypeScript SDK for the Prisma Data Platform Management API. Use the simple client for direct API access, or the full SDK with built-in OAuth authentication and automatic token refresh