All integrations

Postman

Browse and manage Postman workspaces, collections, and environments via the Postman API.

Manual setup 11 tools

Overview

Connect Postman to let AI clients browse and manage your workspaces, collections, and environments programmatically.

Prerequisites

  • A Postman account with API access
  • A stackgate.ai account

Getting credentials

  1. Sign in to Postman.
  2. Open Settings → API keys and generate a new API key. Copy it somewhere safe.
  3. In stackgate.ai, open Integrations → Postman.
  4. Click Activate and paste your API key.
  5. If you use a Postman EU Enterprise account, set the API base URL to https://api.eu.postman.com.

See the Postman API authentication docs for key management and permissions.

Using with AI clients

  • Dedicated endpoint: POST /mcp/postman with a Sanctum bearer token
  • Private gateway: one config for all integrations — use postman__* namespaced tools

See Documentation for HTTP authentication and private gateway setup.

Troubleshooting

  • 422 integration not configured — complete the credential form in My Integrations with your API key.
  • 401 Unauthorized — regenerate the API key in Postman and update your integration credentials.
  • 403 Forbidden — your Postman plan or region may not include the requested feature.
  • 429 Too many requests — Postman rate limits list endpoints to 10 calls per 10 seconds; wait before retrying.
  • Collection or environment not found — use the full UID (userId-itemId) from list tools, not the bare item UUID.

Available tools

  • get_authenticated_user

    Get the Postman user profile and API usage information for the connected API key.

  • list_workspaces

    List Postman workspaces accessible to the connected account.

  • get_workspace

    Get a Postman workspace by ID, including its collections, environments, mocks, and monitors.

  • list_collections

    List Postman collections. Optionally scope to a workspace by ID.

  • get_collection

    Get a Postman collection by UID (userId-itemId), including requests, folders, and variables.

  • list_environments

    List Postman environments accessible to the connected account.

  • get_environment

    Get a Postman environment by UID (userId-itemId), including variable values.

  • create_collection

    Create a new Postman collection in the given workspace.

  • update_collection

    Update an existing Postman collection by UID. Pass the full collection object; remove internal ids such as _postman_id when copying between workspaces.

  • create_environment

    Create a new Postman environment in the given workspace.

  • update_environment

    Update an existing Postman environment by UID.

MCP endpoint: https://stackgate.ai/mcp/postman (HTTP) or via the private gateway.