Documentation

Integrations

Connecting tools

How PIILOT connects external applications to workflow nodes.

PIILOT integrations make workflow nodes runnable against real applications. The Integrations page lists available toolkits, starts authorization, tracks connection status, and exposes connected context to the workflow planner.

When a workflow needs a connector action, PIILOT uses the connected account metadata and toolkit context to compile setup requirements for that node.

Connection lifecycle
sequenceDiagram
  participant U as User
  participant P as PIILOT
  participant C as Composio
  participant A as Connected App
  U->>P: Choose toolkit
  P->>C: Create managed auth link
  C->>A: Start authorization
  A-->>C: Return connected account
  C-->>P: connected_account_id and status
  P->>P: Store connection metadata
  P-->>U: Integration ready for workflows

Connection records

  • Provider, currently Composio for managed integration flows.
  • Toolkit slug and display name.
  • Connection status such as pending_auth or connected.
  • External connected-account identifier.
  • Auth configuration identifier.
  • Redirect URL when authorization is in progress.
  • Metadata such as source surface, auth mode, return target, and connection messages.