From 25c532774f3e555e040097b010fd507a2a14c7b4 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Thu, 2 Apr 2026 15:38:21 +0000
Subject: [PATCH] Document Postman import conversion behavior for non-string
 values and header formats

Generated-By: mintlify-agent
---
 converters/postman-to-bruno.mdx               | 39 +++++++++++++++++--
 .../import-export-data/postman-migration.mdx  |  2 +-
 2 files changed, 37 insertions(+), 4 deletions(-)

diff --git a/converters/postman-to-bruno.mdx b/converters/postman-to-bruno.mdx
index 3b54e921..18895322 100644
--- a/converters/postman-to-bruno.mdx
+++ b/converters/postman-to-bruno.mdx
@@ -1,6 +1,7 @@
 ---
 title: "Postman Conversions"
 sidebarTitle: "Postman to Bruno"
+description: "Convert Postman collections and environments to Bruno format using the @usebruno/converters package."
 ---
 
 <Tabs>
@@ -13,7 +14,7 @@ sidebarTitle: "Postman to Bruno"
   const brunoCollection = postmanToBruno(postmanCollection);
   ```
 
-  ```javascript
+  ```javascript postman-to-bruno.js
   const { postmanToBruno } = require('@usebruno/converters');
   const { readFile, writeFile } = require('fs/promises');
   const path = require('path');
@@ -44,7 +45,7 @@ sidebarTitle: "Postman to Bruno"
   const brunoEnvironment = postmanToBrunoEnvironment(postmanEnvironment);
   ```
 
-  ```javascript 
+  ```javascript postman-env-to-bruno.js
   const { postmanToBrunoEnvironment } = require('@usebruno/converters');
   const { readFile, writeFile } = require('fs/promises');
   const path = require('path');
@@ -66,4 +67,36 @@ sidebarTitle: "Postman to Bruno"
   );
   ```
   </Tab>
-</Tabs>
\ No newline at end of file
+</Tabs>
+
+## 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.
\ No newline at end of file
diff --git a/get-started/import-export-data/postman-migration.mdx b/get-started/import-export-data/postman-migration.mdx
index f29aa624..040794e4 100644
--- a/get-started/import-export-data/postman-migration.mdx
+++ b/get-started/import-export-data/postman-migration.mdx
@@ -108,5 +108,5 @@ With environments properly configured, your API requests will work seamlessly ac
 </Info>
 
 <Info>
-  Postman allows variable values to be numbers, booleans, or objects, but Bruno stores all variable values as strings. During import, non-string values are automatically converted — for example, `5000` becomes `"5000"`, `true` becomes `"true"`, and objects are serialized as JSON strings.
+  Postman allows variable values to be numbers, booleans, or objects, but Bruno stores all variable values as strings. During import, non-string values are automatically converted — for example, `5000` becomes `"5000"`, `true` becomes `"true"`, and objects are serialized as JSON strings. This same coercion applies to authentication credentials, header values, query parameters, and form body fields. See the [Postman to Bruno converter](/converters/postman-to-bruno#conversion-behavior) page for full details.
 </Info>