You can import your existing OpenAPI 3.0 and 3.1 definitions (OpenAPI Specification) into Postman. Postman supports both YAML and JSON formats. Spec Hub supports OpenAPI 3.0, and the Postman API Builder supports OpenAPI 3.0 and 3.1.
To import an API definition into Postman, clickImport in the sidebar. You can choose to upload a file or folder, enter a URL, or paste your raw JSON or YAML. You can also import from a code repository, an API gateway, or an API client. Learn more about how to import an API intothe Postman API Builder andSpec Hub.
If you import an OpenAPI 3.0 definition this way, you’ll only have the option to import the definition into Spec Hub. To import an OpenAPI 3.0 definition into the API Builder,import the file into your API.
After importing your API into the Postman API Builder, you canedit your API definition,validate your definition,generate a collection orgenerate server code based on your definition. You can alsoconnect your API to a Git repository to collaborate with others.
After importing your API into Spec Hub, you canedit your API specification,view and correct syntax errors, orgenerate a collection.
Last modified: 2025/03/03
Explore ready-to-use Collection Templates, build API-first workflows with Postman Flows, and more!