Postman Conversions

Convert Postman collections and environments to Bruno format using the @usebruno/converters package.

Collection

Convert Postman collection to Bruno collection

const { postmanToBruno } = require('@usebruno/converters');

const brunoCollection = postmanToBruno(postmanCollection);

postman-to-bruno.js

const { postmanToBruno } = require('@usebruno/converters');
const { readFile, writeFile } = require('fs/promises');
const path = require('path');

async function convertPostmanToBruno(inputFile, outputFile) {
  try {
    const inputData = await readFile(inputFile, 'utf8');
    const brunoCollection = postmanToBruno(JSON.parse(inputData));
    await writeFile(outputFile, JSON.stringify(brunoCollection, null, 2));
    console.log('Conversion successful!');
  } catch (error) {
    console.error('Error during conversion:', error);
  }
}

convertPostmanToBruno(
  path.join(__dirname, 'demo_collection.postman_collection.json'),
  path.join(__dirname, 'demo_collection.bruno_collection.json')
);

Environment

Convert Postman Environment to Bruno Environment

const { postmanToBrunoEnvironment } = require('@usebruno/converters');

const brunoEnvironment = postmanToBrunoEnvironment(postmanEnvironment);

postman-env-to-bruno.js

const { postmanToBrunoEnvironment } = require('@usebruno/converters');
const { readFile, writeFile } = require('fs/promises');
const path = require('path');

async function convertPostmanEnvironment(inputFile, outputFile) {
  try {
    const inputData = await readFile(inputFile, 'utf8');
    const brunoEnvironment = await postmanToBrunoEnvironment(JSON.parse(inputData));
    await writeFile(outputFile, JSON.stringify(brunoEnvironment, null, 2));
    console.log('Environment conversion successful!');
  } catch (error) {
    console.error('Error during environment conversion:', error);
  }
}

convertPostmanEnvironment(
  path.join(__dirname, 'demo_environment.postman_environment.json'),
  path.join(__dirname, 'demo_environment.bruno_environment.json')
);

Conversion behavior

The converter handles several differences between the Postman and Bruno data formats automatically.

Non-string value coercion

Postman’s schema allows numeric and other non-string values in fields like header values, query parameters, form fields, and authentication credentials. Bruno expects all of these to be strings.

During conversion, non-string values are automatically coerced:

• Numbers (e.g., 5000) become their string equivalent ("5000")
• Objects are serialized as JSON strings
• null or undefined values default to an empty string (or a field-specific fallback for auth fields)

This applies to:

• Request headers, query parameters, and path parameters
• URL-encoded and multipart form body fields
• Authentication fields across all auth types (Basic, Bearer, AWS Signature v4, API Key, Digest, OAuth 1.0, and OAuth 2.0)
• Example request and response fields

Header format normalization

Postman’s v2.1 schema permits headers in several formats. The converter normalizes all of them into Bruno’s standard array-of-objects format:

Postman header format	Example
Array of objects (most common)	[{ "key": "Content-Type", "value": "application/json" }]
Mixed array of strings and objects	["Content-Type: application/json", { "key": "Accept", "value": "*/*" }]
Single concatenated string	"Content-Type: application/json\r\nAccept: */*"
null	Treated as an empty header list

This normalization is applied to request headers, example request headers, and example response headers.