# Parsio.io

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

- **Category:** ai document extraction
- **Auth:** API_KEY
- **Tools:** 24
- **Triggers:** 0
- **Slug:** `PARSIO_IO`
- **Version:** 00000000_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'}). |
| `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 |