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

> Parsio extracts structured data from emails, PDFs, and other documents using configurable parsers.

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

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

## Tools

> [accordion] Get Document
>
> **Slug:** `PARSIO_GET_DOCUMENT`
>
> Get one Parsio document and its mailbox-specific parsed JSON fields.
>
> #### Input Parameters
>
> **document\_id** `string` *required*
>
> Document ID returned by an ingestion or document-list tool.
>
> #### 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
>
> **Slug:** `PARSIO_GET_MAILBOX`
>
> Get settings and parser configuration for one Parsio mailbox.
>
> #### Input Parameters
>
> **mailbox\_id** `string` *required*
>
> Mailbox ID returned by PARSIO\_LIST\_MAILBOXES.
>
> #### 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_LIST_DOCUMENTS`
>
> List and filter documents in a Parsio mailbox, one page at a time.
>
> #### Input Parameters
>
> **query** `string`
>
> Search by document name.
>
> **cursor** `string`
>
> Opaque continuation cursor returned by a previous call. Omit for the first page; the cursor preserves the original mailbox, page size, and filters.
>
> **status** `array`
>
> Return only documents in these processing states. Parsio's statuses are new, parsing, parsed, fail, skipped, quota, exception.
>
> **to\_date** `string`
>
> Include documents on or before this date in YYYY-MM-DD format.
>
> **per\_page** `integer`
>
> Maximum documents to return on this page (1-500).
>
> **from\_date** `string`
>
> Include documents on or after this date in YYYY-MM-DD format.
>
> **mailbox\_id** `string` *required*
>
> Mailbox ID returned by PARSIO\_LIST\_MAILBOXES.
>
> #### 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_LIST_MAILBOXES`
>
> List the Parsio mailboxes available to the connected account so their IDs can be used for parsing and configuration tasks.
>
> #### 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_LIST_TABLE_FIELDS`
>
> List the extraction fields configured for a Parsio mailbox.
>
> #### Input Parameters
>
> **mailbox\_id** `string` *required*
>
> Mailbox ID returned by PARSIO\_LIST\_MAILBOXES.
>
> #### 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 Text Document
>
> **Slug:** `PARSIO_PARSE_TEXT_DOCUMENT`
>
> Submit plain text or HTML to an existing template-based or GPT-powered Parsio mailbox, optionally waiting for the parsed result. This operation creates document data and consumes parsing credits.
>
> #### Input Parameters
>
> **html** `string`
>
> HTML document content. When both html and text are supplied, Parsio uses html.
>
> **name** `string`
>
> Document name or email subject.
>
> **text** `string`
>
> Plain-text document content; required when html is omitted.
>
> **metadata** `object`
>
> Custom JSON metadata returned with parsed output under **meta**.
>
> **mailbox\_id** `string` *required*
>
> ID of a template-based or GPT-powered mailbox.
>
> **sender\_email** `string`
>
> Optional sender email address.
>
> **recipient\_email** `string`
>
> Optional recipient email address.
>
> **wait\_for\_result** `boolean`
>
> If true, wait for parsed data; if false, return after Parsio accepts the document for asynchronous parsing.
>
> #### 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] Reparse Document
>
> **Slug:** `PARSIO_REPARSE_DOCUMENT`
>
> Queue an existing Parsio document to be parsed again. This operation consumes parsing capacity or credits and should not be retried blindly.
>
> #### Input Parameters
>
> **document\_id** `string` *required*
>
> ID of the existing document to reprocess.
>
> #### 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_SKIP_DOCUMENTS`
>
> Mark one or more documents in a Parsio mailbox as skipped. This changes their processing state and cannot be undone through this toolkit.
>
> #### Input Parameters
>
> **mailbox\_id** `string` *required*
>
> Mailbox containing all specified documents.
>
> **document\_ids** `array` *required*
>
> One or more document IDs to mark skipped.
>
> #### 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
>
> **Slug:** `PARSIO_UPDATE_MAILBOX`
>
> Update one or more settings on an existing Parsio mailbox. Provide at least one setting; omitted settings remain unchanged.
>
> #### Input Parameters
>
> **name** `string`
>
> New display name for the mailbox.
>
> **mailbox\_id** `string` *required*
>
> Mailbox ID returned by PARSIO\_LIST\_MAILBOXES.
>
> **email\_prefix** `string`
>
> New inbound mailbox email prefix.
>
> **alert\_email\_h** `integer`
>
> Interval in hours between mailbox email alerts, as reported by PARSIO\_LIST\_MAILBOXES.
>
> **receive\_email** `boolean`
>
> Whether this mailbox should accept inbound email.
>
> **collect\_emails** `boolean`
>
> Whether Parsio should collect email addresses found by this mailbox.
>
> **process\_attachments** `boolean`
>
> Whether Parsio should process attachments received by this 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] Upload Document
>
> **Slug:** `PARSIO_UPLOAD_DOCUMENT`
>
> Upload one file to a Parsio mailbox for parsing, optionally waiting for the result; this creates document data and consumes parsing credits. Synchronous uploads support files up to 20 MB but not ZIP; asynchronous uploads support files up to 50 MB, including ZIP.
>
> #### Input Parameters
>
> **file** `object` *required*
>
> One supported file. Synchronous uploads are limited to 20 MB and cannot be ZIP; asynchronous uploads are limited to 50 MB and may be ZIP.
>
> **metadata** `object`
>
> Custom JSON metadata returned with parsed output under **meta**; sent to Parsio as the multipart meta field.
>
> **mailbox\_id** `string` *required*
>
> ID of the mailbox that should parse the file.
>
> **wait\_for\_result** `boolean`
>
> If true, use synchronous parsing and return parsed data; if false, queue asynchronous parsing and return its document identifier.
>
> #### 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
