Skip to main content

Postman Collection Importer Plugin

The Postman Collection Importer plugin enables smooth migration from Postman v2.1 JSON collections into fully native Voiden .void request files. It automatically converts folders, variables, requests, headers, and bodies into the Voiden ecosystem, leveraging the REST API plugin for formatting and block generation.

How It Works

  1. Open the imported file by clicking on your Postman collection in the left panel to view its contents.
  2. Spot the Magic Button — a prominent "Generate Voiden Files" button appears as your gateway to automated file creation.
  3. Watch the organization happen as a clean, structured folder is automatically created using your Postman collection's exact name.
  4. Discover your new workflow where every API request is intelligently converted into an individual Voiden file, complete with endpoints, parameters, and configurations.

Discover the complete Voiden Postman import workflow

File System Operations​

Automatically creates project structure based on Postman collection hierarchy:

  • Create Directory — mirrors folder nesting from Postman
  • Write File — generates .void files for individual requests

Capability Description: Converts Postman folder/request hierarchy into Voiden's filesystem layout.

Integration Dependencies​

Depends on the voiden-rest-api plugin:

  • Reason: Required for creating valid REST blocks (headers, bodies, method, etc.)
  • Required: Yes

Features​

Import Functionality​

  • Import Postman Collection v2.1 JSON
  • Auto-generate matching folder structure
  • Preserve collection hierarchy & request names
  • Sanitize file and folder names
  • Unlimited nested folder support

Request Conversion​

Converts Postman request structure into Voiden-native blocks:

  • HTTP Methods: GET, POST, PUT, DELETE, PATCH, etc.
  • Headers: mapped to headers-table
  • Query Params: converted to query-table
  • JSON Body: mapped to json_body
  • Form Data: mapped to multipart-table
  • URL-encoded Body
  • Raw Body Conversion: auto-detected and converted to proper Voiden block type

Processing & Optimization​

  • Progress tracking during import
  • Batch file creation with system-safe throttling
  • Generates .void markdown files with proper YAML frontmatter
  • Uses voiden-rest-api helpers for consistent output formatting

Stability & Compatibility​

  • Handles malformed field names gracefully
  • Supports special characters
  • Ensures Voiden-safe path creation

Dependencies​

{
  "core": "^1.0.0",
  "sdk": "^1.0.0",
  "voiden-rest-api": "^1.0.0"
}

Readme Summary​

"Import Postman collections (v2.1) and automatically convert them into Voiden .void request files. Supports nested folders, headers, request bodies, and query parameters."

If you'd like, I can also produce a comparison table between OpenAPI and Postman importers, or merge this into a unified documentation bundle.