Integrations

thinnestAI connects to dozens of external services. Integrations provide your agents with real-world capabilities — reading emails, scheduling meetings, querying databases, and interacting with your existing business tools.

Integration Types

Google Workspace (OAuth)

Gmail

Connect Gmail to let your agents read, search, send, and draft emails.

Setup:

1. Go to Settings > Integrations > Google.
2. Click Connect Gmail.
3. Sign in with your Google account.
4. Grant the requested permissions.
5. Select which agents can use this connection.

Capabilities:

• Read inbox messages
• Search by subject, sender, date
• Send emails
• Create drafts
• Reply to threads

See Gmail Tool Guide for detailed usage.

Google Calendar

Connect Google Calendar for appointment scheduling and availability checking.

Setup:

1. Go to Settings > Integrations > Google.
2. Click Connect Google Calendar.
3. Authorize access to your calendar.

Capabilities:

• List upcoming events
• Check availability for time slots
• Create new events
• Update or cancel existing events
• Handle recurring events

See Google Calendar Tool Guide for detailed usage.

Google Sheets

Connect Google Sheets for reading and writing spreadsheet data.

Setup:

1. Go to Settings > Integrations > Google.
2. Click Connect Google Sheets.
3. Authorize access.

Capabilities:

• Read spreadsheet data
• Write rows and cells
• Search across sheets
• Append data to sheets

See Google Sheets Tool Guide for detailed usage.

API Key Integrations

Configure API keys for third-party services in Settings > Integrations.

Managing Integration Keys

# Store an integration key
curl -X POST https://api.thinnest.ai/integration-keys \
  -H "Authorization: Bearer $THINNESTAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "service": "firecrawl",
    "key_value": "fc-xxxxxxxxxxxxx",
    "name": "Firecrawl Production Key"
  }'

Keys are encrypted at rest using the platform's encryption key.

Supported Services

CRM Integrations

Webhook-Based CRM

Connect any CRM that supports webhooks:

curl -X POST https://api.thinnest.ai/agents/agent_abc123/tools \
  -H "Authorization: Bearer $THINNESTAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "crm_webhook",
    "config": {
      "webhook_url": "https://your-crm.com/api/webhook",
      "auth_header": "Bearer your-crm-token",
      "actions": ["create_contact", "update_contact", "get_contact"]
    }
  }'

Supported CRM Platforms

Communication Integrations

SMS Configuration

Multiple SMS providers are supported:

curl -X POST https://api.thinnest.ai/agents/agent_abc123/tools \
  -H "Authorization: Bearer $THINNESTAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "sms",
    "config": {
      "provider": "twilio",
      "account_sid": "ACxxxxx",
      "auth_token": "xxxxx",
      "from_number": "+14155551234"
    }
  }'

See SMS Tool Guide for detailed setup.

Database Integrations

Connect directly to databases for real-time data access:

Test Database Connection

curl -X POST https://api.thinnest.ai/agents/agent_abc123/tools/test-connection \
  -H "Authorization: Bearer $THINNESTAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "postgres",
    "config": {
      "connection_string": "postgresql://user:pass@host:5432/mydb"
    }
  }'

Webhook Integrations

Create custom integrations using webhooks:

curl -X POST https://api.thinnest.ai/agents/agent_abc123/tools \
  -H "Authorization: Bearer $THINNESTAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "http_request",
    "config": {
      "base_url": "https://api.your-service.com",
      "headers": {
        "Authorization": "Bearer your-token"
      },
      "endpoints": [
        {
          "name": "get_customer",
          "method": "GET",
          "path": "/customers/{id}",
          "description": "Look up a customer by ID"
        },
        {
          "name": "create_ticket",
          "method": "POST",
          "path": "/tickets",
          "description": "Create a support ticket"
        }
      ]
    }
  }'

Your agent can then call these endpoints during conversations.

Security

• API keys are encrypted at rest using AES encryption
• OAuth tokens are refreshed automatically when they expire
• Connection strings are never exposed in API responses
• Origin restrictions for widget integrations prevent unauthorized access
• Integration keys can be rotated without downtime

Managing Integrations

List All Integrations

curl https://api.thinnest.ai/integration-keys \
  -H "Authorization: Bearer $THINNESTAI_API_KEY"

Delete an Integration

curl -X DELETE https://api.thinnest.ai/integration-keys/42 \
  -H "Authorization: Bearer $THINNESTAI_API_KEY"

Best Practices

• Use separate keys for dev and production — Never share API keys across environments.
• Rotate keys regularly — Especially for sensitive integrations like CRMs and payment systems.
• Test connections before deploying — Use the test endpoint to verify database and API connections.
• Limit permissions — When setting up OAuth, grant only the scopes your agent needs.
• Monitor usage — Track which integrations your agents use most in analytics.