---
canonical_url: "https://docs.composio.dev/toolkits/windsor_ai"
markdown_url: "https://docs.composio.dev/toolkits/windsor_ai.md"
product: "platform"
version: null
last_updated: null
---

# Windsor.ai

Windsor.ai connects marketing and business data sources for analytics, reporting, account management, and supported write actions.

- **Category:** analytics
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 6
- **Triggers:** 0
- **Slug:** `WINDSOR_AI`
- **Version:** 20260826_00

## Tools

### List Connector Actions

**Slug:** `WINDSOR_AI_LIST_CONNECTOR_ACTIONS`

Discover Windsor.ai write-action IDs and parameter schemas without executing them. Use 'all' to inspect the currently bounded cross-connector catalog.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `connector` | string | No | Specific connector ID, or 'all' to list action metadata across connectors. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Connector Fields

**Slug:** `WINDSOR_AI_LIST_CONNECTOR_FIELDS`

List queryable field IDs for one specific Windsor.ai connector. This tool rejects connector='all' because that response is unbounded and very large.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `connector` | string | Yes | A specific connector ID from LIST_CONNECTORS; 'all' is not accepted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Connector Options

**Slug:** `WINDSOR_AI_LIST_CONNECTOR_OPTIONS`

List connector-specific query options for one connected Windsor.ai source. Returns a clear error when the source is not connected.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `connector` | string | Yes | Specific connected connector ID; 'all' is not valid for option discovery. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Connectors

**Slug:** `WINDSOR_AI_LIST_CONNECTORS`

List Windsor.ai connector IDs that can be used with discovery, data-query, and account-connection tools.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Co-User Linked Accounts

**Slug:** `WINDSOR_AI_LIST_CO_USER_LINKED_ACCOUNTS`

List source accounts connected through Windsor.ai co-user authorization links, optionally filtered to one connector, without exposing link access tokens.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `connector` | string | No | Optional connector or data-source ID used to filter linked accounts. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Connector Data

**Slug:** `WINDSOR_AI_QUERY_CONNECTOR_DATA`

Query a selected Windsor.ai connector, or 'all' for blended data, using explicit fields and bounded JSON output. Use connector discovery tools first when field or option IDs are unknown.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fields` | array | Yes | One or more field IDs to return. They are sent as one comma-separated fields parameter. |
| `date_to` | string | No | End date in YYYY-MM-DD format; Windsor.ai defaults it to today when omitted. |
| `max_rows` | integer | No | Maximum rows in this single response (1-1000). This is a safety bound, not pagination. |
| `connector` | string | Yes | Connector ID from LIST_CONNECTORS, or 'all' for blended data across connected sources. |
| `date_from` | string | No | Inclusive start date in YYYY-MM-DD format. |
| `date_preset` | string | No | Relative date preset such as last_7d or last_30d; omit when using an explicit date range. |
| `filter_json` | string | No | JSON array string containing [field, operator, value] conditions joined by 'and' or 'or'. Operators include eq, neq, gt, gte, lt, lte, contains, ncontains, null, and notnull. |
| `field_headers` | string ("ids" | "names") | No | Use field IDs as result keys, or request human-readable field names. |
| `refresh_since` | string | No | Optional recent refetch window; the documented default and currently supported value is 3d. |
| `refresh_interval` | string | No | Optional upstream refresh interval such as 6h; minimum values depend on the workspace plan. |
| `connector_options` | object | No | Optional connector-specific query options discovered with LIST_CONNECTOR_OPTIONS. Values must be scalars or scalar arrays. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |