> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Parsio.io

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

![Parsio.io logo](https://mintcdn.com/composio-preview/gqjBKmmJCINafaiK/images/toolkits/parsio_io.svg?fit=max\&auto=format\&n=gqjBKmmJCINafaiK\&q=85\&s=3f872b642c42225006a5caec93bd2b1a)

* **Category:** ai document extraction
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 24
* **Triggers:** 0
* **Slug:** `PARSIO_IO`
* **Version:** 20261101\_00

## Tools

> [accordion] Create HTML/Text Document
>
> **Slug:** `PARSIO_IO_CREATE_HTML_TEXT_DOCUMENT`
>
> Create an HTML or text document in a Parsio mailbox for asynchronous parsing. At least one of HTML or text is required; text and HTML import supports template-based and GPT-powered parsers.
>
> #### Input Parameters
>
> **to** `string`
>
> Recipient's email address
>
> **from** `string`
>
> Sender's email address
>
> **html** `string`
>
> HTML content to parse. At least one of html or text must be provided. If both are provided, HTML takes precedence.
>
> **meta** `object`
>
> Additional payload data as key-value pairs
>
> **name** `string` *required*
>
> Document's name or subject line for emails
>
> **text** `string`
>
> Text content to parse. At least one of html or text must be provided.
>
> **mailbox\_id** `string` *required*
>
> The unique identifier of the mailbox where the document will be processed
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **name** `string` *required*
>
> The name to assign to the new mailbox
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **url** `string` *required*
>
> 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")` *required*
>
> 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` *required*
>
> Whether the webhook is active and should trigger on events.
>
> **table\_id** `string`
>
> Table ID identifier. Required only when event is 'table.parsed'. Leave empty or omit for other event types.
>
> **mailbox\_id** `string` *required*
>
> The unique identifier of the mailbox to attach the webhook to.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **mailbox\_id** `string` *required*
>
> Unique identifier of the mailbox to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **ids** `array` *required*
>
> Array of template IDs to delete. Collection of template identifiers to be removed from the mailbox.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **ids** `array` *required*
>
> Array of webhook IDs to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **ids** `array` *required*
>
> Array of template identifiers to deactivate. Provide template IDs that need to be disabled.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **ids** `array` *required*
>
> Array of template identifiers to activate. Provide template IDs that need to be enabled.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **document\_id** `string` *required*
>
> The unique identifier of the document to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **mailbox\_id** `string` *required*
>
> The unique identifier of the mailbox to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **to** `string`
>
> End date filter in YYYY-MM-DD format to retrieve documents up to this date
>
> **from** `string`
>
> Start date filter in YYYY-MM-DD format to retrieve documents from this date onwards
>
> **page** `integer`
>
> Page number for pagination. Use this to retrieve additional pages of results.
>
> **mailbox\_id** `string` *required*
>
> The unique identifier of the mailbox to retrieve parsed data from
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **template\_id** `string` *required*
>
> Unique identifier of the template to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **webhook\_id** `string` *required*
>
> Unique identifier of the webhook to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **page** `integer`
>
> Page number for pagination. Use this to retrieve additional pages of results.
>
> **mailbox\_id** `string` *required*
>
> Unique identifier of the mailbox to retrieve collected emails from
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **q** `string`
>
> Search query string to filter documents. Searches within document content.
>
> **to** `string`
>
> End date filter in YYYY-MM-DD format. Only documents up to this date will be returned.
>
> **from** `string`
>
> Start date filter in YYYY-MM-DD format. Only documents from this date onwards will be returned.
>
> **page** `integer`
>
> Page number for pagination through results. Use to retrieve additional pages of documents.
>
> **status** `array`
>
> Filter by document status. Multiple statuses can be specified. Accepted values: 'parsed', 'fail', 'skipped', 'new', 'quota', 'parsing', 'exception'.
>
> **mailbox\_id** `string` *required*
>
> The unique identifier of the mailbox to retrieve documents from.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **mailbox\_id** `string` *required*
>
> The unique identifier of the mailbox whose table fields you want to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **page** `integer`
>
> Page number for pagination. Use this to navigate through multiple pages of templates.
>
> **mailbox\_id** `string` *required*
>
> The unique identifier of the mailbox to list templates from
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **mailbox\_id** `string` *required*
>
> The unique identifier for the mailbox whose webhooks you want to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **document\_id** `string` *required*
>
> The unique identifier of the document to parse. This ID is returned when a document is created or uploaded.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **ids** `array` *required*
>
> Array of document IDs to skip. Each ID must be a valid document identifier.
>
> **mailbox\_id** `string` *required*
>
> The unique identifier of the mailbox containing the documents to skip.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **name** `string`
>
> Update the mailbox's display name.
>
> **mailbox\_id** `string` *required*
>
> The unique identifier of the mailbox to update.
>
> **email\_prefix** `string`
>
> Modify the email prefix associated with the mailbox.
>
> **alert\_email\_h** `integer`
>
> Email alerts frequency in hours. Specifies how often to receive alerts.
>
> **collect\_emails** `boolean`
>
> Enable or disable automatic email address collection.
>
> **process\_attachments** `boolean`
>
> Store or ignore email attachments. Set to true to process attachments, false to ignore them.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Webhook
>
> **Slug:** `PARSIO_IO_UPDATE_WEBHOOK`
>
> Update an existing webhook's configuration by supplying its ID, URL, event type, and activation status.
>
> #### Input Parameters
>
> **\_id** `string` *required*
>
> Unique identifier of the webhook to update
>
> **url** `string` *required*
>
> Webhook URL endpoint that will receive webhook payloads
>
> **event** `string ("doc.parsed" | "doc.parsed.flat" | "doc.fail" | "doc.received" | "table.parsed")` *required*
>
> Trigger event type for the webhook. Options: 'doc.parsed', 'doc.parsed.flat', 'doc.fail', 'doc.received', 'table.parsed'
>
> **enabled** `boolean` *required*
>
> Whether the webhook is active or disabled
>
> **table\_id** `string`
>
> Table identifier, required only for 'table.parsed' events. Leave empty for other event types.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload File
>
> **Slug:** `PARSIO_IO_UPLOAD_FILE`
>
> Upload a file to a mailbox for asynchronous parsing and automated data extraction. Supports files up to 50MB, with formats depending on the mailbox parser type, including ZIP files.
>
> #### Input Parameters
>
> **file** `object` *required*
>
> File to upload and parse. Supported formats: PDF, HTML, CSV, TXT, DOCX, RTF, or XML. Maximum file size: 20MB.
>
> **meta** `object`
>
> 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` *required*
>
> The unique identifier of the mailbox where the file will be uploaded
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
