Integrations

List available integrations and resolve dynamic properties.

Integrations

The Integrations API lets you discover available integrations, view their actions and triggers, and resolve dynamic input values that depend on a live connection.

List Integrations

GET/api/v1/integrations

List all available integrations, or fetch a specific one by name. This endpoint does not require authentication.

Query Parameters

Field	Type	Required	Description
`name`	string	No	Fetch a specific integration by name

Response (list)

json

{
  "integrations": [
    {
      "name": "slack",
      "displayName": "Slack",
      "description": "Send messages and manage channels",
      "logoUrl": "data:image/svg+xml;base64,...",
      "categories": ["communication"],
      "auth": {
        "type": ["OAUTH2"],
        "oauth2": { "authUrl": "https://slack.com/oauth/v2/authorize" }
      },
      "actions": {
        "send_channel_message": {
          "name": "send_channel_message",
          "displayName": "Send Channel Message",
          "description": "Send a message to a Slack channel",
          "props": {}
        }
      },
      "triggers": {}
    }
  ],
  "total": 34,
  "registered": ["slack", "gmail", "github"]
}

The registered array lists integration names that have at least one connection or MCP server tool configured in your organization.

Response (single, with ?name=slack)

json

{
  "integration": {
    "name": "slack",
    "displayName": "Slack",
    "description": "Send messages and manage channels",
    "logoUrl": "data:image/svg+xml;base64,...",
    "categories": ["communication"],
    "auth": { "type": ["OAUTH2"] },
    "actions": { "send_channel_message": { ... } },
    "triggers": {}
  }
}

Example

bash

curl https://api.weavz.io/api/v1/integrations

typescript

import { WeavzClient } from '@weavz/sdk'
 
const client = new WeavzClient({ apiKey: 'wvz_your_api_key' })
 
const { integrations } = 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')
const data = await res.json()

python

import httpx
 
res = httpx.get("https://api.weavz.io/api/v1/integrations")
data = res.json()

Errors

Status	Code	Description
`404`	`INTEGRATION_NOT_FOUND`	Integration with the given name not found

Resolve Input Options

POST/api/v1/integrations/:integrationName/properties/options

Resolve available options for select inputs in an action or trigger. This fetches available values from the connected service (e.g., list of Slack channels, Google Sheets spreadsheets).

Path Parameters

Field	Type	Description
`integrationName`	string	Integration name

Request Body

Field	Type	Required	Description
`propertyName`	string	Yes	Property to resolve options for
`actionName`	string	No	Action containing the property
`triggerName`	string	No	Trigger containing the property
`connectionExternalId`	string	No	Connection for authenticated requests
`workspaceId`	string (uuid)	No	Workspace scope
`endUserId`	string	No	Your end-user's identifier for per-user connection resolution
`input`	object	No	Current form values (for inputs that depend on other field values)
`searchValue`	string	No	Filter options by search text

Provide either actionName or triggerName, not both.

Response

json

{
  "options": [
    { "label": "#general", "value": "C0123456789" },
    { "label": "#engineering", "value": "C9876543210" }
  ],
  "disabled": false
}

Example

bash

curl -X POST https://api.weavz.io/api/v1/integrations/slack/properties/options \
  -H "Authorization: Bearer wvz_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "propertyName": "channel",
    "actionName": "send_channel_message",
    "connectionExternalId": "slack-main"
  }'

typescript

const { options } = await client.integrations.resolveOptions('slack', {
  propertyName: 'channel',
  actionName: 'send_channel_message',
  connectionExternalId: 'slack-main',
})

python

result = client.integrations.resolve_options(
    "slack",
    property_name="channel",
    action_name="send_channel_message",
    connection_external_id="slack-main",
)

typescript

const res = await fetch('https://api.weavz.io/api/v1/integrations/slack/properties/options', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wvz_your_api_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    propertyName: 'channel',
    actionName: 'send_channel_message',
    connectionExternalId: 'slack-main',
  }),
})
const data = await res.json()

python

res = httpx.post(
    "https://api.weavz.io/api/v1/integrations/slack/properties/options",
    headers={"Authorization": "Bearer wvz_your_api_key"},
    json={
        "propertyName": "channel",
        "actionName": "send_channel_message",
        "connectionExternalId": "slack-main",
    },
)
data = res.json()

Errors

Status	Code	Description
`400`	`NOT_DROPDOWN`	Property does not support value resolution
`400`	`NO_OPTIONS_FN`	No values available to resolve
`400`	`OPTIONS_FAILED`	Options function threw an error
`404`	`INTEGRATION_NOT_FOUND`	Integration not found

Resolve Dynamic Properties

POST/api/v1/integrations/:integrationName/properties/resolve

Resolve a dynamic property schema. Dynamic properties are properties whose schema depends on runtime values (e.g., column fields that change based on a selected spreadsheet).

Path Parameters

Field	Type	Description
`integrationName`	string	Integration name

Request Body

Field	Type	Required	Description
`propertyName`	string	Yes	Dynamic property to resolve
`actionName`	string	No	Action containing the property
`triggerName`	string	No	Trigger containing the property
`connectionExternalId`	string	No	Connection for authenticated requests
`workspaceId`	string (uuid)	No	Workspace scope
`endUserId`	string	No	Your end-user's identifier for per-user connection resolution
`input`	object	No	Current form values

Response

The response is the resolved property schema, which varies per integration:

json

{
  "column_a": {
    "type": "SHORT_TEXT",
    "displayName": "Name",
    "required": true
  },
  "column_b": {
    "type": "NUMBER",
    "displayName": "Amount",
    "required": false
  }
}

Example

bash

curl -X POST https://api.weavz.io/api/v1/integrations/google-sheets/properties/resolve \
  -H "Authorization: Bearer wvz_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "propertyName": "columns",
    "actionName": "insert_row",
    "connectionExternalId": "google-sheets-main",
    "input": {
      "spreadsheet_id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms",
      "sheet_id": "Sheet1"
    }
  }'

typescript

const result = await client.integrations.resolveProperty('google-sheets', {
  propertyName: 'columns',
  actionName: 'insert_row',
  connectionExternalId: 'google-sheets-main',
  input: {
    spreadsheet_id: '1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms',
    sheet_id: 'Sheet1',
  },
})

python

result = client.integrations.resolve_property(
    "google-sheets",
    property_name="columns",
    action_name="insert_row",
    connection_external_id="google-sheets-main",
    input={
        "spreadsheet_id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms",
        "sheet_id": "Sheet1",
    },
)

typescript

const res = await fetch('https://api.weavz.io/api/v1/integrations/google-sheets/properties/resolve', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wvz_your_api_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    propertyName: 'columns',
    actionName: 'insert_row',
    connectionExternalId: 'google-sheets-main',
    input: {
      spreadsheet_id: '1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms',
      sheet_id: 'Sheet1',
    },
  }),
})
const data = await res.json()

python

res = httpx.post(
    "https://api.weavz.io/api/v1/integrations/google-sheets/properties/resolve",
    headers={"Authorization": "Bearer wvz_your_api_key"},
    json={
        "propertyName": "columns",
        "actionName": "insert_row",
        "connectionExternalId": "google-sheets-main",
        "input": {
            "spreadsheet_id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms",
            "sheet_id": "Sheet1",
        },
    },
)
data = res.json()

Errors

Status	Code	Description
`400`	`NOT_DYNAMIC`	Property is not a dynamic type
`400`	`NO_PROPS_FN`	Property has no resolve function
`400`	`RESOLVE_FAILED`	Resolve function threw an error
`404`	`INTEGRATION_NOT_FOUND`	Integration not found

Get OAuth Status

GET/api/v1/integrations/oauth-status

Check which integrations have OAuth apps configured (either platform-provided or custom).

Response

json

{
  "configured": ["slack", "google-sheets", "github", "gmail", "notion", "discord", "hubspot"]
}

Example

bash

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

typescript

const { configured } = await client.integrations.oauthStatus()

python

result = client.integrations.oauth_status()

typescript

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

python

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