# Parsio.io

No-code email parser to extract and export valuable data from emails, PDFs and documents

- **Category:** ai document extraction
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 24
- **Triggers:** 0
- **Slug:** `PARSIO_IO`
- **Version:** 20260307_00

## Tools

### Create HTML/Text Document

**Slug:** `PARSIO_IO_CREATE_HTML_TEXT_DOCUMENT`

Tool to create and parse HTML or text documents via API. Use when you need to submit HTML or text content to a Parsio mailbox for data extraction. At least one of html or text must be provided.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to` | string | No | Recipient's email address |
| `from` | string | No | Sender's email address |
| `html` | string | No | HTML content to parse. At least one of html or text must be provided. If both are provided, HTML takes precedence. |
| `meta` | object | No | Additional payload data as key-value pairs |
| `name` | string | Yes | Document's name or subject line for emails |
| `text` | string | No | Text content to parse. At least one of html or text must be provided. |
| `mailbox_id` | string | Yes | The unique identifier of the mailbox where the document will be processed |

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

### Create Mailbox

**Slug:** `PARSIO_IO_CREATE_MAILBOX`

Tool to create a new mailbox with a specified name. Use when you need to set up a new mailbox for email parsing in Parsio.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The name to assign to the new mailbox |

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

### Create Webhook

**Slug:** `PARSIO_IO_CREATE_WEBHOOK`

Tool to create a new webhook for a mailbox with specified URL, event trigger, and settings. Use when you need to register a webhook endpoint to receive automated notifications for mailbox events.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The webhook URL where events will be sent. Must be a valid HTTPS URL. |
| `event` | string ("doc.parsed" | "doc.parsed.flat" | "doc.fail" | "doc.received" | "table.parsed") | Yes | Trigger event type for the webhook. Accepted values: 'doc.parsed' for parsed documents, 'doc.parsed.flat' for flat parsed data, 'doc.fail' for failed documents, 'doc.received' for received documents, 'table.parsed' for parsed tables (requires table_id). |
| `enabled` | boolean | Yes | Whether the webhook is active and should trigger on events. |
| `table_id` | string | No | Table ID identifier. Required only when event is 'table.parsed'. Leave empty or omit for other event types. |
| `mailbox_id` | string | Yes | The unique identifier of the mailbox to attach the webhook to. |

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

**Slug:** `PARSIO_IO_DELETE_MAILBOX`

Tool to delete a specific mailbox from your Parsio account. Use when you need to permanently remove a mailbox.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mailbox_id` | string | Yes | Unique identifier of the mailbox 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 Templates

**Slug:** `PARSIO_IO_DELETE_TEMPLATES`

Tool to delete multiple templates by providing an array of template IDs. Use when you need to remove one or more templates from a mailbox.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ids` | array | Yes | Array of template IDs to delete. Collection of template identifiers to be removed from the mailbox. |

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

**Slug:** `PARSIO_IO_DELETE_WEBHOOKS`

Tool to delete multiple webhooks from a mailbox. Use when you need to remove one or more webhook configurations by providing their IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ids` | array | Yes | Array of webhook IDs 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 |

### Disable Templates

**Slug:** `PARSIO_IO_DISABLE_TEMPLATES`

Tool to disable multiple templates by providing an array of template IDs. Use when you need to deactivate multiple templates in a mailbox.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ids` | array | Yes | Array of template identifiers to deactivate. Provide template IDs that need to be disabled. |

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

### Enable Templates

**Slug:** `PARSIO_IO_ENABLE_TEMPLATES`

Tool to enable multiple templates by providing an array of template IDs. Use when you need to activate multiple templates for use in a mailbox.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ids` | array | Yes | Array of template identifiers to activate. Provide template IDs that need to be enabled. |

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

**Slug:** `PARSIO_IO_GET_DOCUMENT`

Tool to retrieve a specific document with parsed data as JSON. Use when you need to fetch details of a document by its ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `document_id` | string | Yes | The unique identifier of the document to retrieve |

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

**Slug:** `PARSIO_IO_GET_MAILBOX`

Tool to retrieve details of a specific mailbox. Use when you need to fetch configuration and settings for a particular mailbox.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mailbox_id` | string | Yes | The unique identifier of the mailbox to retrieve. |

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

**Slug:** `PARSIO_IO_GET_PARSED_DATA`

Tool to get parsed data from a mailbox with optional date range filters and pagination. Use when you need to retrieve extracted information from documents that have been processed through Parsio's parsing system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to` | string | No | End date filter in YYYY-MM-DD format to retrieve documents up to this date |
| `from` | string | No | Start date filter in YYYY-MM-DD format to retrieve documents from this date onwards |
| `page` | integer | No | Page number for pagination. Use this to retrieve additional pages of results. |
| `mailbox_id` | string | Yes | The unique identifier of the mailbox to retrieve parsed data from |

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

**Slug:** `PARSIO_IO_GET_TEMPLATE`

Tool to retrieve details of a specific parsing template by its ID. Use when you need to inspect a template's configuration, fields, or status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template_id` | string | Yes | Unique identifier of the template to retrieve |

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

**Slug:** `PARSIO_IO_GET_WEBHOOK`

Tool to retrieve details of a specific webhook by its ID. Use when you need to inspect a webhook's configuration, status, or event type.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_id` | string | Yes | Unique identifier of the webhook to retrieve |

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

**Slug:** `PARSIO_IO_LIST_COLLECTED_EMAILS`

Tool to list all collected email addresses from a specific mailbox. Use when you need to retrieve email addresses that have been automatically collected during document parsing. The mailbox must have the 'collect_emails' setting enabled.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. Use this to retrieve additional pages of results. |
| `mailbox_id` | string | Yes | Unique identifier of the mailbox to retrieve collected emails from |

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

**Slug:** `PARSIO_IO_LIST_DOCUMENTS`

Tool to retrieve a list of documents from a specific mailbox. Use when you need to list documents with optional filtering by date range, search query, or processing status. Supports pagination for large result sets.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | No | Search query string to filter documents. Searches within document content. |
| `to` | string | No | End date filter in YYYY-MM-DD format. Only documents up to this date will be returned. |
| `from` | string | No | Start date filter in YYYY-MM-DD format. Only documents from this date onwards will be returned. |
| `page` | integer | No | Page number for pagination through results. Use to retrieve additional pages of documents. |
| `status` | array | No | Filter by document status. Multiple statuses can be specified. Accepted values: 'parsed', 'fail', 'skipped', 'new', 'quota', 'parsing', 'exception'. |
| `mailbox_id` | string | Yes | The unique identifier of the mailbox to retrieve documents from. |

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

**Slug:** `PARSIO_IO_LIST_MAILBOXES`

Tool to retrieve all mailboxes in the account. Use when you need to list all available mailboxes and their configurations.

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

**Slug:** `PARSIO_IO_LIST_TABLE_FIELDS`

Tool to list all table fields in a specific mailbox. Use when you need to view the structure of data fields available for a mailbox.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mailbox_id` | string | Yes | The unique identifier of the mailbox whose table fields you want to retrieve. |

#### 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 Templates in Mailbox

**Slug:** `PARSIO_IO_LIST_TEMPLATES`

Tool to list all parsing templates associated with a specific mailbox. Use when you need to retrieve all template configurations for a mailbox, including their enabled status and metadata. Supports pagination for mailboxes with many templates.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. Use this to navigate through multiple pages of templates. |
| `mailbox_id` | string | Yes | The unique identifier of the mailbox to list templates from |

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

**Slug:** `PARSIO_IO_LIST_WEBHOOKS`

Tool to retrieve all webhooks configured for a specific mailbox. Use when you need to list webhooks associated with a mailbox.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mailbox_id` | string | Yes | The unique identifier for the mailbox whose webhooks you want to retrieve. |

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

### Parse Document

**Slug:** `PARSIO_IO_PARSE_DOCUMENT`

Tool to trigger parsing of a specific document. Use when you need to initiate parsing for a document that has already been uploaded or created in Parsio.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `document_id` | string | Yes | The unique identifier of the document to parse. This ID is returned when a document is created or uploaded. |

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

### Skip Documents

**Slug:** `PARSIO_IO_SKIP_DOCUMENTS`

Tool to skip multiple documents in a mailbox by providing document IDs. Use when you need to mark documents as skipped rather than parsing them.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ids` | array | Yes | Array of document IDs to skip. Each ID must be a valid document identifier. |
| `mailbox_id` | string | Yes | The unique identifier of the mailbox containing the documents to skip. |

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

**Slug:** `PARSIO_IO_UPDATE_MAILBOX`

Tool to update mailbox settings including name, email prefix, and processing options. Use when you need to modify configuration settings for an existing mailbox.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Update the mailbox's display name. |
| `mailbox_id` | string | Yes | The unique identifier of the mailbox to update. |
| `email_prefix` | string | No | Modify the email prefix associated with the mailbox. |
| `alert_email_h` | integer | No | Email alerts frequency in hours. Specifies how often to receive alerts. |
| `collect_emails` | boolean | No | Enable or disable automatic email address collection. |
| `process_attachments` | boolean | No | Store or ignore email attachments. Set to true to process attachments, false to ignore them. |

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

**Slug:** `PARSIO_IO_UPDATE_WEBHOOK`

Tool to update an existing webhook's configuration. Use when you need to modify webhook settings like URL, event type, or activation status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `_id` | string | Yes | Unique identifier of the webhook to update |
| `url` | string | Yes | Webhook URL endpoint that will receive webhook payloads |
| `event` | string ("doc.parsed" | "doc.parsed.flat" | "doc.fail" | "doc.received" | "table.parsed") | Yes | Trigger event type for the webhook. Options: 'doc.parsed', 'doc.parsed.flat', 'doc.fail', 'doc.received', 'table.parsed' |
| `enabled` | boolean | Yes | Whether the webhook is active or disabled |
| `table_id` | string | No | Table identifier, required only for 'table.parsed' events. Leave empty for other event types. |

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

### Upload File

**Slug:** `PARSIO_IO_UPLOAD_FILE`

Tool to upload and parse PDF, HTML, CSV, TXT, DOCX, RTF or XML files (max 20MB) to a mailbox. Use when you need to submit a file to Parsio for automated data extraction.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | object | Yes | File to upload and parse. Supported formats: PDF, HTML, CSV, TXT, DOCX, RTF, or XML. Maximum file size: 20MB. |
| `meta` | object | No | Custom payload data that will be included in the parsed JSON output as __meta__ field. Useful for linking the document with external databases (e.g., {'order_id': '12345', 'customer': 'John Doe'}). |
| `file_path` | string | No | Optional local file path to read the file content from. If provided, this will be used instead of the file reference. Useful for testing or when the file is available locally. |
| `mailbox_id` | string | Yes | The unique identifier of the mailbox where the file will be uploaded |

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