# Postman importer

## Introduction

The **Postman importer** is used to build a connector from a Postman collection. You can:

* Upload a Postman collection from a file
* Provide a URL to a Postman collection

The Patchworks Postman importer will then attempt to:

* create the system/connector 
* create system variables 
* create authentication type (OAuth 1 & 2; Token; API key; Basic) 
* create authentication variables 
* create endpoints (including variables)
* enable the authentication type for all endpoints

{% hint style="info" %}
These are all the elements of a connector that you would expect to configure by using the [Connector Builder](/product-documentation/developer-hub/connector-builder.md) to build your connector manually.
{% endhint %}

Any item the importer cannot complete is flagged for you to add/adjust manually after the import.

## Need to know

* The maximum file size allowed for import is 50MB.

## Using the Postman importer

**Step 1**\
Locate the Postman file or collection URL that you want to use. 

**Step 2**\
Log into the Patchworks dashboard, then select **connectors & instances** from the left-hand navigation menu:

<figure><img src="/files/WppF4cOheDnEgOcAaP0v" alt=""><figcaption></figcaption></figure>

**Step 3**\
Click the **import Postman collection** link at the top of the page:

<figure><img src="/files/mpJFLF2yrkc3NU0fzUgs" alt=""><figcaption></figcaption></figure>

**Step 4**\
Choose whether to import a file, or to provide a URL:

<figure><img src="/files/SW8io5ygH6pShur43Xu8" alt=""><figcaption></figcaption></figure>

**Step 5**\
Select the appropriate option below for the next step:

<details>

<summary><img src="/files/mjTTZzyEQN7pfYDU3Ixl" alt="" data-size="line">  File upload</summary>

Selecting the **file upload** option prompts you to select a file:

![](/files/rrnZUYdDszNpBwq1MbJd)

Click the **choose file** button to locate and select the required file on your local or network drive. Once selected, the file is uploaded and the filename is confirmed - for example:

&#x20;![](/files/yoWeC9WDirNFbnnfztRq)

</details>

<details>

<summary><img src="/files/mjTTZzyEQN7pfYDU3Ixl" alt="" data-size="line"> URL</summary>

Selecting the **URL** option prompts you to provide a URL:

![](/files/cZOIZsAf0Rnm5gZbQNp1)

Enter the full URL to your collection - for example:

&#x20;![](/files/YfuR4jKI1mePiDGoyHDh)

</details>

**Step 6**\
Click the **confirm** button:

<figure><img src="/files/vngazZlcPk9jZokNhD7b" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
If you toggle ON the **update existing connector?** option, the setup for an existing connector found with the same name will be overwritten. If you leave this option OFF and an existing connector with the same name is found, the import will add a new version alongside the original. If in doubt, leave this option set to OFF.
{% endhint %}

**Step 7**\
The Postman collection is imported and a new connector is added to your list. Any setup that could not be completed is displayed - for example:

<figure><img src="/files/7oHLtKR9ewaK4OeW6fL3" alt=""><figcaption></figcaption></figure>

**Step 8**\
You can now edit the connector and add any setup that the Postman importer was not able to complete:

<figure><img src="/files/GjLDeDA9v5GTlrt8VKo5" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
For information on connector setup options please see [Building your own connector](/product-documentation/developer-hub/connector-builder/building-your-own-connector.md).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.wearepatchworks.com/product-documentation/developer-hub/postman-importer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.