> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getkadabra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecting Services

> Securely authenticate external tools like Google Docs, Slack, HubSpot etc to enable automation

# Authentication & Connections

To automate workflows, Kadabra needs permission to interact with your external tools (such as posting to Slack, updating HubSpot, or reading from Notion). We prioritize security and transparency in how these connections are handled.

## The Agent Approach (Recommended)

The fastest way to authenticate is to let the AI Agent guide you.

When you ask the Agent to build a flow involving an external tool, it will automatically detect if authentication is required. It will prompt you at the exact right moment to sign in, ensuring the connection is scoped correctly for the task at hand.

<Tip>
  **Best Practice:** Simply type "Create a flow that sends a Slack message when a new lead arrives." The Agent will handle the logic and present the login button when needed.
</Tip>

## Manual Connection Setup

If you prefer to build your flow manually or need to add a specific integration yourself, follow these steps:

<Steps>
  <Step title="Open the Node Library">
    <img src="https://mintcdn.com/kadabra/c3rByra1TGZujZb-/images/Screenshot2026-01-11at9.00.48.png?fit=max&auto=format&n=c3rByra1TGZujZb-&q=85&s=e931a0148c76bad058eaf85b7bf02022" alt="Open Node Library" width="2296" height="1349" data-path="images/Screenshot2026-01-11at9.00.48.png" />

    Click the **Add Node** button located on the top right of the Canvas.
  </Step>

  <Step title="Select your Tool">
    <img src="https://mintcdn.com/kadabra/c3rByra1TGZujZb-/images/Screenshot2026-01-11at9.02.27.png?fit=max&auto=format&n=c3rByra1TGZujZb-&q=85&s=f7ba6879d046421f2d25128ffe009de1" alt="Tool Selection" width="1672" height="1478" data-path="images/Screenshot2026-01-11at9.02.27.png" />

    Drag the relevant service node (e.g., **Slack**, **HubSpot**, **Gmail**) onto your canvas.
  </Step>

  <Step title="Initiate Connection">
    <img src="https://mintcdn.com/kadabra/c3rByra1TGZujZb-/images/Screenshot2026-01-11at9.03.34.png?fit=max&auto=format&n=c3rByra1TGZujZb-&q=85&s=8b0f4c6b1bff7a96b27ab0f92d4f1f32" alt="Connection Initiation " title="Screenshot2026 01 11at9 03 34" style={{ width:"100%" }} width="2694" height="1196" data-path="images/Screenshot2026-01-11at9.03.34.png" />

    Click the **Connect to X (Service Name)** button in the node properties panel.
  </Step>

  <Step title="Review Security Standards">
    <img src="https://mintcdn.com/kadabra/c3rByra1TGZujZb-/images/Screenshot2026-01-11at9.04.02.png?fit=max&auto=format&n=c3rByra1TGZujZb-&q=85&s=a1ec579b3fa6a6d822de477eb0069d08" alt="Kadabra Security" title="Screenshot2026 01 11at9 04 02" style={{ width:"44%" }} width="996" height="1280" data-path="images/Screenshot2026-01-11at9.04.02.png" />

    A security overview screen will appear. We believe in transparency regarding how your keys are encrypted and stored.
  </Step>

  <Step title="Authenticate">
    A standard OAuth window for the service will open. Sign in and grant Kadabra the necessary permissions to execute your workflow.
  </Step>

  <Step title="Success">
    Once authorized, the window will close, and the node will show a "Connected" status. This credential is now saved for future use across other flows.
  </Step>
</Steps>

## Security & Permissions

We treat your credentials with the highest level of security.

<CardGroup cols="2">
  <Card title="Encryption" icon="lock">
    Your access tokens are encrypted using industry-standard protocols. We never see your raw passwords.
  </Card>

  <Card title="Scoped Access" icon="shield-check">
    We only request the specific permissions required to execute the actions you select in your flow.
  </Card>
</CardGroup>

## Managing Credentials

You can view, update, or revoke your existing connections at any time.

<Info>
  Need to remove a connection? Please refer to our guide on [Deleting Credentials](/how-to/delete-credentials).
</Info>
