Intermediate6 min

Importing APIs

Import any REST API to use in your workflows. Multiple import methods available.

Import Methods

From OpenAPI/Swagger

Best for APIs with documentation:

  1. Go to Plugins > Import API
  2. Select OpenAPI/Swagger
  3. Enter URL or paste spec
  4. Review detected endpoints
  5. Click Import

From curl Command

Quick import from examples:

  1. Go to Plugins > Import API
  2. Select From curl
  3. Paste your curl command
  4. AI extracts endpoint details
  5. Review and import

Manual Configuration

Full control over setup:

  1. Go to Plugins > Import API
  2. Select Manual
  3. Enter base URL
  4. Add endpoints one by one
  5. Configure authentication

Configuring Imported APIs

Base URL

The root URL for all endpoints:

https://api.example.com/v1

Authentication

Choose auth method:

| Method | Configuration | |--------|---------------| | None | No auth required | | API Key | Header or query param | | Bearer | Token in Authorization header | | Basic | Username and password | | OAuth 2.0 | Full OAuth flow |

Headers

Add default headers:

  • Content-Type
  • Accept
  • Custom headers

Endpoints

For each endpoint, configure:

  • Method: GET, POST, PUT, DELETE
  • Path: /users/{id}
  • Parameters: Path, query, body
  • Response: Expected structure

Using Imported APIs

In Workflows

  1. Add HTTP Request node
  2. Select your imported API
  3. Choose endpoint
  4. Fill parameters
  5. Connect to flow

Testing

Before using in workflows:

  1. Click Test on the endpoint
  2. Enter sample parameters
  3. View response
  4. Verify it works

Managing Imports

View Imported APIs

  1. Go to Plugins > My Imports
  2. See all imported APIs
  3. Click to edit or delete

Updating

When API changes:

  1. Open the imported API
  2. Click Re-import or edit manually
  3. Update affected workflows

Sharing

Share imported APIs with team:

  1. Open the API
  2. Click Share
  3. Choose team visibility

Best Practices

1. Use OpenAPI When Available

Most accurate import method.

2. Test All Endpoints

Verify each endpoint works before building workflows.

3. Document Your Imports

Add descriptions for team understanding.

4. Handle Errors

Configure error responses for robustness.

Next Steps

Tags

integrationsapisimport