***

title: Import an API specification
updated: 2025-10-15T00:00:00.000Z
max-toc-depth: 2
----------------

You can import an existing OpenAPI 2.0, 3.0, or 3.1 specifications or AsyncAPI 2.0 specifications in Spec Hub. Import a single or multi-file OpenAPI 2.0, 3.0, or 3.1 specification as a collection or a specification and collection. Import an AsyncAPI 2.0 specification as a specification in Spec Hub only.

<Info class="iconless-callout">
  If you try to import an unsupported format using **Import** in the sidebar, Postman only gives you the option to [import into the API Builder](/docs/design-apis/api-builder/importing-an-api/).
</Info>

1. Click **Import** in the sidebar.

2. Choose one of the following options to import an OpenAPI 2.0, 3.0, or 3.1 specification or AsyncAPI 2.0 specification file:

   * Click **files**, then select a specification file.

   * Click **folder**, then select a folder with a [multi-file OpenAPI specification](/docs/design-apis/specifications/add-files-to-a-specification/).

     <Info class="iconless-callout">
       You can also import more than one multi-file OpenAPI specification at the same time.
     </Info>

   * Enter a link to a specification file.

   * Paste raw text.

   * Import from a remote GitHub, Bitbucket, GitLab, or Azure DevOps repository. Click **Other Sources**, and then select **GitHub**, **Bitbucket**, **GitLab**, or **Azure**. Follow the instructions to sign in to your repository. Then select the repository and other relevant details and select the branch you want to import from.

3. If you're importing a single or multi-file OpenAPI specification, choose how you'd like to import it into Postman, then click **Import**. Note that an AsyncAPI 2.0 specification is automatically imported as a new specification in Spec Hub.

   * **Postman Collection** - Generates a collection with folders, requests, and response examples based on the specification. A new specification isn't created in Spec Hub.

   * **OpenAPI Specification with a Postman Collection** - Generates a collection from the provided specification and creates a new specification in Spec Hub. For OpenAPI 3.0 specifications, if you update it, you can then update the collection with the latest changes to the specification. Learn more about [keeping OpenAPI collections in sync with a specification](/docs/design-apis/specifications/generate-collections/#keep-collections-in-sync-with-an-openapi-specification).

     <Info class="iconless-callout">
       If you're importing more than one multi-file OpenAPI 2.0, 3.0, or 3.1 specification, you can also choose how you'd like to import them into Postman. By default, Postman generates a collection based on each specification. You can select the **Import these as specs** checkbox to create a new specification in Spec Hub for each multi-file specification.
     </Info>

   You can also click <img alt="Setting icon" src="https://assets.postman.com/postman-docs/aether-icons/descriptive-setting-stroke.svg#icon" width="16px" /> **View Import Settings** for more configuration options. These options will vary depending on your specification.

4. In the **Importing** message that displays in the Postman footer, click <img alt="Open in Postman icon" src="https://assets.postman.com/postman-docs/aether-icons/action-openInPostman-stroke.svg#icon" width="16px" /> **Go to Specification** next to a specification or <img alt="Open in Postman icon" src="https://assets.postman.com/postman-docs/aether-icons/action-openInPostman-stroke.svg#icon" width="16px" /> **Go to Collection** next to a collection.

<Info class="iconless-callout">
  Your [Postman plan](https://www.postman.com/pricing/) gives you a limited number of specifications in your team's internal workspaces. Learn more about [resource usage in Postman](/docs/billing/resource-usage/#specifications).
</Info>

{/* */}

<Info class="iconless-callout">
  Postman stores your authorized accounts so you can use them to connect to other repositories and services. Learn more about [managing connected accounts](/docs/getting-started/installation/settings/#connected-accounts) for remote repositories.
</Info>