Integrations

Browse available integrations and understand their capabilities.

Integrations

An integration represents a third-party service in Weavz. Each integration defines its authentication method, available actions (operations you can perform), and triggers (events you can listen for).

Authentication Types

Each integration requires a specific authentication type:

Type	Description	Example
OAuth2	Full OAuth2 flow with authorization URL, token exchange, and refresh	Slack, GitHub, Google services
API Key	Simple secret key or token	OpenAI, SendGrid
Basic Auth	Username and password	Some legacy APIs
Custom Auth	Multiple fields defined by the integration	Airtable (base + token)
None	No authentication required	Storage, KV Store

OAuth2 integrations support PKCE (Proof Key for Code Exchange) for enhanced security during the authorization flow.

Available Integrations

Weavz ships with 500+ pre-built external integrations. Here are some highlights:

Integration	Auth Type	Key Actions
Airtable	Custom Auth	Create/read/update records, list bases
Asana	OAuth2	Create tasks, list projects, manage workspaces
ClickUp	OAuth2	Create tasks, manage lists and spaces
Discord	OAuth2	Send messages, manage channels, list guilds
Dropbox	OAuth2	Upload/download files, list folders
Figma	OAuth2	Get file info, list projects
GitHub	OAuth2	Create issues, manage repos, list PRs
Gmail	OAuth2	Send/read emails, manage labels
Google Calendar	OAuth2	Create/list events, manage calendars
Google Contacts	OAuth2	Create/list contacts
Google Drive	OAuth2	Upload/download files, list folders
Google Forms	OAuth2	List forms, get responses
Google Sheets	OAuth2	Read/write rows, create spreadsheets
Google Tasks	OAuth2	Create/list tasks and task lists
HubSpot	OAuth2	Manage contacts, deals, companies
HTTP	Custom Auth	Send HTTP requests (GET, POST, etc.)
Intercom	OAuth2	Send messages, manage contacts
Jira	OAuth2	Create issues, manage projects, list boards
Linear	OAuth2	Create issues, manage projects and teams
Microsoft Teams	OAuth2	Send messages, list channels and teams
Monday	OAuth2	Create items, manage boards
Notion	OAuth2	Create/query databases, manage pages
OpenAI	API Key	Chat completions, text generation
Salesforce	OAuth2	Manage leads, contacts, opportunities
Shopify	OAuth2	Manage products, orders, customers
Slack	OAuth2	Send messages, manage channels, list users
Telegram Bot	API Key	Send messages, manage chats
Todoist	OAuth2	Create tasks, manage projects
Trello	OAuth2	Create cards, manage boards and lists
Twilio	API Key	Send SMS, make calls
Typeform	OAuth2	List forms, get responses

Built-in Integrations

These integrations are provided by Weavz and require no external authentication:

Integration	Description
Storage	File storage (read, write, delete, list files) backed by object storage
KV Store	Key-value store for persistent state (put, get, delete, lists)
Code	Execute JavaScript in a lightweight sandbox — ideal for data transformation
Advanced Code	Multi-language sandbox (JS, Python, Shell) with persistent state and storage

Learn more about Storage and KV Store · Learn more about Code & Sandbox

Actions vs Triggers

Each integration can expose two types of capabilities:

Actions

Actions are operations you initiate — sending a message, creating a record, uploading a file. You call them via the REST API, through MCP servers, or from the dashboard Playground.

bash

curl -X POST https://api.weavz.io/api/v1/actions/execute \
  -H "Authorization: Bearer wvz_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "integrationName": "slack",
    "actionName": "send_channel_message",
    "workspaceId": "proj_abc123",
    "input": {
      "channel": "#general",
      "text": "Hello from Weavz!"
    }
  }'

typescript

import { WeavzClient } from '@weavz/sdk'
const client = new WeavzClient({ apiKey: 'wvz_your_api_key' })
 
await client.actions.execute('slack', 'send_channel_message', {
  workspaceId: 'proj_abc123',
  input: {
    channel: '#general',
    text: 'Hello from Weavz!',
  },
})

python

from weavz_sdk import WeavzClient
client = WeavzClient(api_key="wvz_your_api_key")
 
client.actions.execute("slack", "send_channel_message",
    workspace_id="proj_abc123",
    input={
        "channel": "#general",
        "text": "Hello from Weavz!",
    },
)

typescript

const res = await fetch('https://api.weavz.io/api/v1/actions/execute', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wvz_your_api_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    integrationName: 'slack',
    actionName: 'send_channel_message',
    workspaceId: 'proj_abc123',
    input: {
      channel: '#general',
      text: 'Hello from Weavz!',
    },
  }),
})
const data = await res.json()

python

import httpx
res = httpx.post(
    "https://api.weavz.io/api/v1/actions/execute",
    headers={"Authorization": "Bearer wvz_your_api_key"},
    json={
        "integrationName": "slack",
        "actionName": "send_channel_message",
        "workspaceId": "proj_abc123",
        "input": {
            "channel": "#general",
            "text": "Hello from Weavz!",
        },
    },
)
data = res.json()

Triggers

Triggers are events that happen externally — a new message arrives, a form is submitted, a file is uploaded. You enable a trigger and provide a callback URL where Weavz delivers the events.

bash

curl -X POST https://api.weavz.io/api/v1/triggers/enable \
  -H "Authorization: Bearer wvz_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "integrationName": "github",
    "triggerName": "new_issue",
    "workspaceId": "proj_abc123",
    "input": {
      "repo": "my-org/my-repo"
    },
    "callbackUrl": "https://your-app.com/webhooks/github"
  }'

typescript

import { WeavzClient } from '@weavz/sdk'
const client = new WeavzClient({ apiKey: 'wvz_your_api_key' })
 
await client.triggers.enable({
  integrationName: 'github',
  triggerName: 'new_issue',
  workspaceId: 'proj_abc123',
  input: {
    repo: 'my-org/my-repo',
  },
  callbackUrl: 'https://your-app.com/webhooks/github',
})

python

from weavz_sdk import WeavzClient
client = WeavzClient(api_key="wvz_your_api_key")
 
client.triggers.enable(
    integration_name="github",
    trigger_name="new_issue",
    workspace_id="proj_abc123",
    input={"repo": "my-org/my-repo"},
    callback_url="https://your-app.com/webhooks/github",
)

typescript

const res = await fetch('https://api.weavz.io/api/v1/triggers/enable', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wvz_your_api_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    integrationName: 'github',
    triggerName: 'new_issue',
    workspaceId: 'proj_abc123',
    input: { repo: 'my-org/my-repo' },
    callbackUrl: 'https://your-app.com/webhooks/github',
  }),
})
const data = await res.json()

python

import httpx
res = httpx.post(
    "https://api.weavz.io/api/v1/triggers/enable",
    headers={"Authorization": "Bearer wvz_your_api_key"},
    json={
        "integrationName": "github",
        "triggerName": "new_issue",
        "workspaceId": "proj_abc123",
        "input": {"repo": "my-org/my-repo"},
        "callbackUrl": "https://your-app.com/webhooks/github",
    },
)
data = res.json()

Not all integrations support both actions and triggers. Use the integration metadata endpoint to discover what's available:

bash

curl https://api.weavz.io/api/v1/integrations/slack \
  -H "Authorization: Bearer wvz_your_api_key"

typescript

import { WeavzClient } from '@weavz/sdk'
const client = new WeavzClient({ apiKey: 'wvz_your_api_key' })
 
const { integration } = await client.integrations.get('slack')

python

from weavz_sdk import WeavzClient
client = WeavzClient(api_key="wvz_your_api_key")
 
result = client.integrations.get("slack")
integration = result["integration"]

typescript

const res = await fetch('https://api.weavz.io/api/v1/integrations?name=slack', {
  headers: {
    'Authorization': 'Bearer wvz_your_api_key',
  },
})
const data = await res.json()

python

import httpx
res = httpx.get(
    "https://api.weavz.io/api/v1/integrations",
    headers={"Authorization": "Bearer wvz_your_api_key"},
    params={"name": "slack"},
)
data = res.json()

Listing Integrations

All integrations

bash

curl https://api.weavz.io/api/v1/integrations \
  -H "Authorization: Bearer wvz_your_api_key"

typescript

import { WeavzClient } from '@weavz/sdk'
const client = new WeavzClient({ apiKey: 'wvz_your_api_key' })
 
const { integrations, total } = await client.integrations.list()

python

from weavz_sdk import WeavzClient
client = WeavzClient(api_key="wvz_your_api_key")
 
result = client.integrations.list()
integrations = result["integrations"]

typescript

const res = await fetch('https://api.weavz.io/api/v1/integrations', {
  headers: {
    'Authorization': 'Bearer wvz_your_api_key',
  },
})
const data = await res.json()

python

import httpx
res = httpx.get(
    "https://api.weavz.io/api/v1/integrations",
    headers={"Authorization": "Bearer wvz_your_api_key"},
)
data = res.json()

Single integration details

bash

curl https://api.weavz.io/api/v1/integrations/slack \
  -H "Authorization: Bearer wvz_your_api_key"

typescript

import { WeavzClient } from '@weavz/sdk'
const client = new WeavzClient({ apiKey: 'wvz_your_api_key' })
 
const { integration } = await client.integrations.get('slack')

python

from weavz_sdk import WeavzClient
client = WeavzClient(api_key="wvz_your_api_key")
 
result = client.integrations.get("slack")
integration = result["integration"]

typescript

const res = await fetch('https://api.weavz.io/api/v1/integrations?name=slack', {
  headers: {
    'Authorization': 'Bearer wvz_your_api_key',
  },
})
const data = await res.json()

python

import httpx
res = httpx.get(
    "https://api.weavz.io/api/v1/integrations",
    headers={"Authorization": "Bearer wvz_your_api_key"},
    params={"name": "slack"},
)
data = res.json()

The response includes full metadata — display name, logo, auth configuration, available actions with input schemas, and available triggers.

Next Steps

Connections — authenticate with integrations
Actions — execute integration actions
Triggers — listen for integration events