This guide shows you how to connect popular apps to your Kapso project using App integrations.

​
Prerequisites

  • A Kapso project
  • App integrations addon enabled

​
Enable the App integrations addon

  1. Go to Project Settings → Billing
  2. In the Addons section, toggle on App integrations
  3. Click Save

​
Example: Google Calendar

Connect Google Calendar to check availability, create events, and manage schedules.

​
Available actions

  • List Events - Get calendar events for a time range
  • Create Event - Add new events to calendar
  • Update Event - Modify existing events
  • Delete Event - Remove events

​
Setup steps

  1. Navigate to Code & integrations → App integrations
  2. Click Configure New Action
  3. Search for “Google Calendar” and select it
  4. Choose your desired action (e.g., “List Events”)
  5. Click Connect Account and authorize your Google account
  6. Configure the action parameters:
    • Use {{variableName}} syntax for dynamic values
    • Example: {{startTime}}, {{endTime}}, {{eventTitle}}
  7. Name your integration (e.g., “Check Calendar Availability”)
  8. Click Save

​
Example configuration

Calendar ID: primary
Time Min: {{timeMin}}
Time Max: {{timeMax}}
Single Events: true
Order By: startTime

​
Using integrations in agents

Once configured, use your app integrations in SubagentNode with webhook tools: 
from kapso.builder.nodes.subagent import WebhookTool

# Add to your SubagentNode
subagent.add_tool(WebhookTool(
    name="send_slack_message",
    url="https://app.kapso.ai/api/v1/integrations/YOUR_INTEGRATION_ID/invoke",
    http_method="POST",
    headers={"X-API-Key": "#{KAPSO_API_KEY}"},
    description="Send message to Slack",
    body_schema={
        "type": "object",
        "properties": {
            "channelName": {"type": "string"},
            "messageText": {"type": "string"}
        }
    }
))

​
Using integrations via API

You can invoke your configured integrations directly via the Kapso API: 
curl -X POST https://app.kapso.ai/api/v1/integrations/YOUR_INTEGRATION_ID/invoke \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "timeMin": "2024-03-20T09:00:00Z",
    "timeMax": "2024-03-20T17:00:00Z"
  }'

​
Finding your integration ID

  1. Go to Code & integrations → App integrations
  2. Click on your configured integration
  3. Click Get code to see the integration ID and example

​
Response format

The API returns the raw response from the connected service. For Google Calendar List Events: 
{
  "kind": "calendar#events",
  "items": [
    {
      "id": "event123",
      "summary": "Team Meeting",
      "start": {
        "dateTime": "2024-03-20T10:00:00Z"
      },
      "end": {
        "dateTime": "2024-03-20T11:00:00Z"
      }
    }
  ]
}

​
Available apps

Kapso supports 2,800+ app integrations. Search for your favorite apps in the App integrations section!