Integration

Import OpenAPI Specifications

Auto-generate workflow nodes from your API spec. Import OpenAPI or Swagger files to create fully typed, ready-to-use API nodes in seconds.

8 min readIntermediateLast updated: December 2024

5 Steps to Import Your API

Transform your OpenAPI spec into workflow nodes in under 10 minutes.

  1. 1

    Prepare Your OpenAPI Spec

    Export your API specification in OpenAPI 3.0+ or Swagger 2.0 format. Most API tools (Postman, Swagger Editor, Stoplight) can export to these formats.

    Pro Tips:

    • OpenAPI 3.0+ is recommended for best compatibility
    • JSON and YAML formats are both supported
    • Ensure your spec includes authentication schemes
  2. 2

    Navigate to API Import

    From your workflow editor, click the 'Add Node' button and select 'Import API'. You can also access this from the integrations panel.

    Pro Tips:

    • Drag and drop your spec file directly onto the canvas
    • Paste a URL to import from a hosted spec
    • Import from popular API directories automatically
  3. 3

    Configure Authentication

    Set up the authentication method for your API. We detect auth schemes from your spec and let you configure credentials securely.

    Pro Tips:

    • API keys, OAuth 2.0, and Bearer tokens are supported
    • Credentials are encrypted and stored securely
    • Test authentication before importing endpoints
  4. 4

    Select Endpoints to Import

    Choose which API endpoints to generate nodes for. You can import all endpoints or select specific ones you need for your workflow.

    Pro Tips:

    • Group endpoints by tag or path for organization
    • Filter by HTTP method (GET, POST, PUT, DELETE)
    • Preview the generated node before importing
  5. 5

    Use Your Generated Nodes

    Drag your new API nodes onto the canvas. Each endpoint becomes a configurable node with typed inputs based on your spec's parameters.

    Pro Tips:

    • Parameters are auto-typed from your schema
    • Required fields are marked automatically
    • Response schemas enable intelligent data mapping

Supported Formats

We support all major API specification formats.

OpenAPI 3.0+

Recommended

Full support with all features

OpenAPI 3.1

Supported

Latest spec with JSON Schema alignment

Swagger 2.0

Supported

Legacy format with automatic conversion

Postman Collections

Supported

Import directly from Postman exports

Common Issues & Solutions

Quick fixes for the most common import problems.

Spec validation errors

Use the Swagger Editor (editor.swagger.io) to validate your spec before importing. Fix any schema violations.

Missing authentication

Ensure your spec includes securitySchemes. If not, you can manually configure auth during import.

Complex nested schemas

Deeply nested objects are flattened into form fields. Use $ref for reusable components.

Frequently Asked Questions

Common questions about OpenAPI import.

Ready to Import Your API?

Turn your OpenAPI spec into workflow nodes in minutes. Start building powerful API integrations today.