Agentic Workers
Core featuresIntegrations

Connecting Integrations

Step-by-step guide to connecting external services

Connecting Integrations

Connecting Integrations

This guide walks you through connecting integrations to enable your agents to use external tools and services.

Before You Start

What You'll Need

  • An Agentic Workers account
  • Access to the service you want to connect
  • Appropriate permissions for the service

Integration Types

There are two main types of integrations:

  1. OAuth Integrations: Most services use OAuth (Google, Slack, Notion, etc.)
  2. API Key Integrations: Some services require API keys (Stripe, Mailchimp, Linear, etc.)

OAuth Integrations

OAuth integrations use secure authorization flows. Here's how to connect them:

Step 1: Navigate to Integrations

  1. Log in to Agentic Workers
  2. Click Integrations in the sidebar
  3. Browse available integrations

Step 2: Select Integration

  1. Find the integration you want (e.g., Google, Slack, Notion)
  2. Click on the integration icon
  3. You'll see connection options

Step 3: Authorize Access

  1. Click "Connect" or "Authorize"
  2. You'll be redirected to the service's authorization page
  3. Log in to the service if needed
  4. Review permissions requested
  5. Click "Allow" or "Authorize"

Step 4: Confirm Connection

  1. You'll be redirected back to Agentic Workers
  2. The integration should show as Connected (green checkmark)
  3. The integration is now available for your agents

Common OAuth Integrations

  • Google: Google Docs, Sheets, Calendar
  • Slack: Team messaging
  • Notion: Knowledge management
  • Airtable: Database management
  • HubSpot: CRM
  • LinkedIn: Social media

API Key Integrations

Some integrations require API keys. Here's how to set them up:

Step 1: Get API Key

  1. Log in to the service's developer portal
  2. Navigate to API settings or developer section
  3. Create a new API key
  4. Copy the API key (you won't see it again!)

Step 2: Connect in Agentic Workers

  1. Go to Integrations in Agentic Workers
  2. Find the integration (e.g., Stripe, Mailchimp, Linear)
  3. Click "Connect"
  4. Enter your API key
  5. Click "Save" or "Connect"

Step 3: Verify Connection

  1. Check integration status
  2. Should show as Connected
  3. Test the connection if possible

Common API Key Integrations

  • Stripe: Payment processing
  • Mailchimp: Email marketing
  • Linear: Project management
  • Firecrawl: Web scraping

Integration-Specific Guides

Google Workspace

Connecting Google:

  1. Click Google in Integrations
  2. Authorize Agentic Workers
  3. Select which Google services to enable
  4. Confirm connection

Services Available:

  • Google Docs
  • Google Sheets
  • Google Calendar

Slack

Connecting Slack:

  1. Click Slack in Integrations
  2. Select your workspace
  3. Authorize Agentic Workers
  4. Confirm permissions

Permissions Needed:

  • Post messages
  • Read messages
  • List channels

Notion

Connecting Notion:

  1. Click Notion in Integrations
  2. Authorize Agentic Workers
  3. Select pages to share
  4. Confirm connection

Note: You can limit which Notion pages are accessible.

Stripe

Connecting Stripe:

  1. Get API key from Stripe dashboard
  2. Go to Integrations → Stripe
  3. Enter API key
  4. Save connection

Security: Keep API keys secure and never share them.

Managing Connections

Viewing Connected Integrations

  1. Go to Integrations
  2. Connected integrations show green checkmark
  3. Click any integration to see details

Disconnecting

  1. Go to Integrations
  2. Click on connected integration
  3. Click "Disconnect"
  4. Confirm disconnection

Resetting Connections

If an integration isn't working:

  1. Click on the integration
  2. Click "Reset" or "Reconnect"
  3. Re-authorize the connection
  4. Test again

Troubleshooting

Authorization Fails

Possible Issues:

  • Popup blocked (enable popups)
  • Wrong account logged in
  • Service unavailable

Solutions:

  • Enable popups in browser
  • Log out and log back in
  • Try again later

API Key Not Working

Possible Issues:

  • Incorrect API key
  • Key expired or revoked
  • Wrong permissions

Solutions:

  • Verify API key is correct
  • Generate new API key
  • Check key permissions

Connection Lost

Possible Issues:

  • Token expired
  • Permissions revoked
  • Service changed

Solutions:

  • Reconnect integration
  • Re-authorize access
  • Check service status

Integration Not Available

Possible Issues:

  • Not yet supported
  • Regional restrictions
  • Service limitations

Solutions:

  • Check supported integrations list
  • Contact support if needed
  • Use alternative integration

Security Best Practices

OAuth Integrations

  • Review permissions: Only grant necessary access
  • Regular audits: Periodically review connected services
  • Revoke unused: Disconnect integrations you don't use

API Keys

  • Keep secure: Never share API keys
  • Rotate regularly: Update keys periodically
  • Limit permissions: Use keys with minimum necessary permissions
  • Monitor usage: Check for unusual activity

Next Steps

Available Tools

Complete reference of all available tools and integrations

Integrations Overview

Connect external services and tools to empower your agents

On this page

Connecting IntegrationsBefore You StartWhat You'll NeedIntegration TypesOAuth IntegrationsStep 1: Navigate to IntegrationsStep 2: Select IntegrationStep 3: Authorize AccessStep 4: Confirm ConnectionCommon OAuth IntegrationsAPI Key IntegrationsStep 1: Get API KeyStep 2: Connect in Agentic WorkersStep 3: Verify ConnectionCommon API Key IntegrationsIntegration-Specific GuidesGoogle WorkspaceSlackNotionStripeManaging ConnectionsViewing Connected IntegrationsDisconnectingResetting ConnectionsTroubleshootingAuthorization FailsAPI Key Not WorkingConnection LostIntegration Not AvailableSecurity Best PracticesOAuth IntegrationsAPI KeysNext Steps