Guides›Composio Quickstart (Console)

Composio Quickstart (Console)

This is the fastest way to get Composio tools working from Rooaak Console.

Prerequisites

  • You are signed into Rooaak Console with access to the target project.
  • You already created an agent (or will create one during this flow).

Step 1: Add Composio key once (Project Settings)

Open:

  • Console -> Project Settings -> Composio

Under Step 1: Add Composio API key:

  • Paste your Composio key (cmp_...)
  • Click Save Composio API Key

Notes:

  • This is project-scoped and reused for all enabled providers.
  • Console only shows last4; raw secret is never shown again.

Step 2: Enable providers (Project Settings)

Under Step 2: Enable providers:

  • Enable providers you want (for example Gmail, Calendar, Slack, Drive).
  • Rooaak auto-creates and maintains Composio-managed authConfigId for each enabled provider.

Expected status:

  • Enabled
  • Auth: Managed by Rooaak (Composio)

Step 3: Set agent default execution principal

Open:

  • Console -> Agent -> Composio

In Default Execution Principal choose:

  • Service account (business) for shared business-owned accounts.
  • End user (per conversation) when each user must act as themselves.

Click Save Default Principal.

Step 4: Link accounts

Service account linking

In Service Account Linking:

  • Click Connect (or Re-link) per provider.
  • Complete the provider OAuth flow.
  • You are redirected back to the agent Composio tab.
  • Status should become Connected.

End-user linking (template generator)

In End-User Linking (V1 API):

  • Select provider.
  • Enter endUserId.
  • Click Generate Request Template.
  • Use the generated request from your backend for each app user.

Step 5: Validate

  • Confirm provider row status is Connected for the principal you expect.
  • Send a message that triggers a Composio tool.
  • If needed, use Composio Troubleshooting.