Import Swagger APIs

View as Markdown

Postman can import APIs created with the Swagger tool suite.

The terms Swagger and OpenAPI can be confusing because the OpenAPI specification was named Swagger, and people sometimes use the terms interchangeably. To clarify, in this document, Swagger API refers to an API created with the Swagger tool suite.

Import a Swagger API

  1. In Postman, click Import in the sidebar.

  2. Select an API definition file, enter a link to the API, or paste your raw text.

  3. You can choose to import the definition as a collection or as an API along with a collection.

    API definition import options
    Tip

    Click View Import Settings for more configuration options. These options will vary depending on your API specification.

  4. Click Import.

  5. An Import Complete message displays in the footer. In the message, click Open in Postman icon Go to Collection next to a collection or API to open the imported element.

    Import complete message