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

# Wistia

Wistia is a video marketing platform for hosting and managing media, channels, webinars, audience analytics, and account content.

- **Category:** video & audio
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `WISTIA`
- **Version:** 00000000_00

## Tools

### Create Folder

**Slug:** `WISTIA_CREATE_FOLDER`

Create a Wistia folder for organizing media, optionally make it public, and optionally set the specified email as its owner.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the new folder. |
| `is_public` | boolean | No | Whether the folder is publicly accessible. |
| `admin_email` | string | No | Email address of the person to set as the folder owner. Defaults to the Wistia Account Owner. |

#### 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 |

### Delete Folder

**Slug:** `WISTIA_DELETE_FOLDER`

Delete a Wistia folder by hashed ID. This is destructive, but deleted content may remain recoverable for a limited account-dependent window before permanent purge.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `folder_hashed_id` | string | Yes | Hashed ID of the folder to delete. |

#### 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 |

### Delete Media

**Slug:** `WISTIA_DELETE_MEDIA`

Delete one Wistia media item by hashed ID. This is destructive, but Wistia keeps deleted media recoverable for a limited account-dependent window before permanent purge.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `media_hashed_id` | string | Yes | Hashed ID of the media item to delete. |

#### 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 |

### Get Analytics Summary

**Slug:** `WISTIA_GET_ANALYTICS_SUMMARY`

Return account-wide or single-media Wistia performance metrics for an inclusive start date and exclusive end date.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end_date` | string | Yes | Exclusive analytics end date in YYYY-MM-DD format; must be after start_date. |
| `start_date` | string | Yes | Inclusive analytics start date in YYYY-MM-DD format. |
| `media_hashed_id` | string | No | Optional media hashed ID. Omit for account-wide metrics. |

#### 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 |

### Get Media

**Slug:** `WISTIA_GET_MEDIA`

Return detailed metadata, assets, folder placement, tags, and processing state for one Wistia media item.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `media_hashed_id` | string | Yes | Hashed ID of the media item. |
| `description_format` | string | No | Return the media description as markdown. |

#### 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 |

### Import Media from URL

**Slug:** `WISTIA_IMPORT_MEDIA_FROM_URL`

Start importing a publicly reachable media URL into Wistia, optionally into a folder. The response may be queued; call WISTIA_GET_MEDIA until its status is ready before using the media.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Publicly reachable URL of the media file to import. |
| `name` | string | No | Optional display name for the imported media. |
| `description` | string | No | Optional media description. |
| `low_priority` | boolean | No | Queue the import at lower processing priority. |
| `folder_hashed_id` | string | No | Optional hashed ID of the destination folder. |

#### 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 |

### Search Content

**Slug:** `WISTIA_SEARCH_CONTENT`

Search the connected Wistia account for media, folders, subfolders, channels, and channel episodes by text and optional filters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | No | Optional tag names; results matching any supplied tag are returned. |
| `query` | string | Yes | Text to search for in Wistia content. |
| `created_after` | string | No | Only return resources created at or after this UTC ISO 8601 timestamp. |
| `created_before` | string | No | Only return resources created at or before this UTC ISO 8601 timestamp. |
| `resource_types` | array | No | Optional resource types: media, folder, subfolder, channel, or channel_episode. |

#### 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 |

### Set Media Archived State

**Slug:** `WISTIA_SET_MEDIA_ARCHIVED_STATE`

Archive one or more media items, or restore archived media into a destination folder, and wait for Wistia's background job to finish. Requires the connected account to have access to Wistia's Archiving feature.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `archived` | boolean | Yes | True to archive the media; false to restore it. |
| `folder_hashed_id` | string | No | Destination folder hashed ID. Required only when restoring media. |
| `media_hashed_ids` | array | Yes | One to 100 media hashed IDs to archive or restore. |
| `wait_timeout_seconds` | integer | No | Maximum seconds to wait for the background job to finish (1-600). |

#### 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 |

### Update Folder

**Slug:** `WISTIA_UPDATE_FOLDER`

Update a Wistia folder's name, description, public visibility, or anonymous transfer settings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New folder name. |
| `is_public` | boolean | No | Whether the folder is publicly accessible. |
| `description` | string | No | New folder description. |
| `folder_hashed_id` | string | Yes | Hashed ID of the folder to update. |
| `anonymous_can_upload` | boolean | No | Whether anonymous visitors may upload to the folder. |
| `anonymous_can_download` | boolean | No | Whether anonymous visitors may download from the folder. |

#### 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 |

### Update Media

**Slug:** `WISTIA_UPDATE_MEDIA`

Update a Wistia media item's name, description, tags, or still image reference. Wistia returns descriptions as normalized HTML.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New media name. |
| `tags` | array | No | Complete tag-name list to apply to the media. Use an empty list to remove all tags. |
| `description` | string | No | New media description. Wistia may normalize this content to HTML in the response. |
| `media_hashed_id` | string | Yes | Hashed ID of the media item to update. |
| `new_still_media_id` | string | No | Optional media ID to use as the new still image. |

#### 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 |