# Parseur

Parseur is an AI-powered data extraction tool that automates the parsing of emails, PDFs, and other documents into structured data.

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

## Tools

### Copy Document

**Slug:** `PARSEUR_COPY_DOCUMENT`

Tool to copy a document to another mailbox. Use when you need to duplicate a document from one mailbox to another mailbox within Parseur.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the document to copy. |
| `target_mailbox_id` | string | Yes | The unique identifier of the target mailbox (parser) where the document will be copied. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 |

### Copy Mailbox

**Slug:** `PARSEUR_COPY_MAILBOX`

Tool to copy a mailbox (parser) in Parseur. Creates a duplicate of the mailbox with all its configuration. Use when you need to duplicate an existing parser setup.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Unique identifier of the mailbox (parser) to copy. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 custom download

**Slug:** `PARSEUR_CREATE_CUSTOM_DOWNLOAD`

Tool to create a custom download (export configuration) for a mailbox. Use when you need to define which fields should be exported to CSV or XLS format.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Numeric ID for the export configuration |
| `name` | string | Yes | Name for the custom download |
| `type` | string ("PARSER" | "PARSER_FIELD") | No | Type of export configuration: PARSER for full parser exports, or PARSER_FIELD for field-specific exports |
| `items` | array | Yes | List of field names to include in the export. Common system fields include: DocumentID, Sender, SenderName, Template, Recipient, ParsedAt, etc. |
| `parser_id` | string | Yes | ID of the mailbox (parser) for which to create the custom download |
| `csv_download` | string | Yes | Identifier or filename for the CSV download |
| `xls_download` | string | Yes | Identifier or filename for the XLS download |
| `parser_field_id` | string | No | Parser field ID starting with PF (required when type is PARSER_FIELD) |
| `parser_field_name` | string | No | Name of the parser field (required when type is PARSER_FIELD) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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:** `PARSEUR_CREATE_MAILBOX`

Tool to create a new mailbox (parser) in Parseur. Use when you need to set up a new parser for document parsing with custom configuration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | The name of the parser/mailbox. If not specified, a default name will be assigned. |
| `ai_engine` | string ("DISABLED" | "GCP_AI_1" | "GCP_AI_2" | "GCP_AI_2_5") | No | AI engine options for document parsing. |
| `force_ocr` | boolean | No | Whether to force OCR on every document uploaded to this parser. |
| `ai_instructions` | string | No | General AI instructions for this parser to guide the parsing behavior. |
| `retention_policy` | integer | No | Number of days documents and data are stored before deletion. Default is 90 days. |
| `allowed_extensions` | array | No | List of file extensions allowed for processing. If not specified, all extensions are enabled. |
| `master_parser_slug` | string ("invoices" | "statements" | "job-application" | "leads" | "resume-cv" | "food-delivery" | "search-alerts" | "real-estate" | "work-order" | "financial-statement" | "utility" | "contact-list" | "delivery-notes" | "property-bookings" | "job-search" | "travel" | "automotive" | "payslip" | "event-ticketing") | No | Master parser template options. |
| `process_attachments` | boolean | No | Whether email attachment processing is enabled on this parser. |
| `identification_status` | string ("REQUESTED" | "PROGRESS" | "COMPLETED" | "MANUAL") | No | Identification status options for the parser. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 custom download

**Slug:** `PARSEUR_DELETE_CUSTOM_DOWNLOAD`

Tool to delete a custom download (export configuration) from a mailbox. Use when permanently removing an export configuration after confirming its ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the custom download (export configuration) to delete. |
| `mailbox_id` | string | Yes | Unique identifier of the mailbox (parser) that contains the custom download. Obtain from List Mailboxes action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 document

**Slug:** `PARSEUR_DELETE_DOCUMENT`

Tool to delete a specific document by ID. Use when permanently removing a document after confirming its ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `document_id` | string | Yes | Unique identifier of the document to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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:** `PARSEUR_DELETE_MAILBOX`

Tool to delete a mailbox (parser) by ID. Use when permanently removing a mailbox after confirming its ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Unique identifier of the mailbox (parser) to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 webhook

**Slug:** `PARSEUR_DELETE_WEBHOOK`

Tool to delete a specific webhook. Use when permanently removing a webhook after confirming its ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_id` | integer | Yes | Unique identifier of the webhook to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 webhook

**Slug:** `PARSEUR_DISABLE_WEBHOOK`

Tool to disable a webhook for a mailbox. Removes the webhook association from the specified mailbox. Use when you need to stop an active webhook from sending parsed data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mailbox_id` | integer | Yes | Unique numeric ID of the parser mailbox containing the webhook. Obtain via List Mailboxes action. |
| `webhook_id` | integer | Yes | Unique numeric ID of the active webhook to disable. Obtain from webhook_set via List Webhooks action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 webhook

**Slug:** `PARSEUR_ENABLE_WEBHOOK`

Enables a paused webhook for a specified mailbox, allowing it to receive and forward parsed document events. Use this action to re-enable a webhook that was previously paused. Only webhooks listed in 'available_webhook_set' (paused webhooks) can be enabled. After enabling, the webhook will appear in 'webhook_set' (active webhooks) and begin sending HTTP POST requests to its target URL when the configured event occurs (e.g., document.processed).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mailbox_id` | integer | Yes | Unique numeric ID of the parser mailbox containing the webhook. Obtain via List Mailboxes action. |
| `webhook_id` | integer | Yes | Unique numeric ID of the paused webhook to enable. Obtain from available_webhook_set via List Webhooks action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 Bootstrap Config

**Slug:** `PARSEUR_GET_BOOTSTRAP_CONFIG`

Tool to retrieve bootstrap configuration data. Use when you need system-wide configuration choices, field format mappings, maximum field lengths, or master parser definitions.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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:** `PARSEUR_GET_DOCUMENT`

Tool to retrieve full details of a specific document by ID. Returns document status, processing info, parsed results, and download URLs for JSON, CSV, and XLS formats.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the document to retrieve. Obtain this ID from the List Documents action or webhook payloads. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 Logs

**Slug:** `PARSEUR_GET_DOCUMENT_LOGS`

Tool to get document logs for a specific document. Returns paginated list of logs with status, source, and message details. Use when you need to troubleshoot or audit document processing history.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier (numeric ID) of the document to retrieve logs for. Obtain this ID from the List Documents action. |
| `page` | integer | No | Page number to retrieve (pagination). Defaults to 1. |
| `search` | string | No | Case-insensitive partial match search across log entries. |
| `ordering` | string | No | Field name to order by. Prepend a minus (-) for descending order, e.g., '-created'. |
| `page_size` | integer | No | Number of log entries per page. Defaults to 25. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 by ID

**Slug:** `PARSEUR_GET_MAILBOX`

Tool to retrieve full mailbox (parser) configuration by ID. Use when you need complete details about a specific mailbox including fields, webhooks, and settings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The unique identifier (numeric ID) of the mailbox to retrieve. Obtain this from the List Mailboxes action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 Schema

**Slug:** `PARSEUR_GET_MAILBOX_SCHEMA`

Tool to retrieve the JSON schema for a mailbox's parsed fields. Use when you need to understand the structure and types of data fields extracted by a specific parser.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mailbox_id` | string | Yes | The unique identifier (numeric ID) of the mailbox to retrieve the schema for. Obtain this ID from the List Mailboxes action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 Custom Downloads

**Slug:** `PARSEUR_LIST_CUSTOM_DOWNLOADS`

Tool to retrieve custom downloads (export configurations) for a mailbox. Use when you need to list available export formats and their download URLs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier (numeric ID) of the mailbox (parser) whose export configurations you want to list. Obtain this from the List Mailboxes action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 in Mailbox

**Slug:** `PARSEUR_LIST_DOCUMENTS_IN_MAILBOX`

Tool to list documents within a specific mailbox. Use when you need to paginate, search, or sort the documents of a given mailbox after obtaining its ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tz` | string | No | Timezone for interpreting date filters, e.g., 'Asia/Singapore'. Defaults to UTC. |
| `page` | integer | No | Page number to retrieve (pagination). Defaults to 1. |
| `search` | string | No | Search query to filter documents by ID, name, template name, sender/recipient, or metadata. |
| `ordering` | string ("name" | "-name" | "created" | "-created" | "modified" | "-modified" | "status" | "-status") | No | Field to sort by. Prepend a minus for descending order. Supported: name, created, modified, status. |
| `page_size` | integer | No | Number of items per page. Defaults to 25. |
| `mailbox_id` | string | Yes | The unique identifier (numeric ID) of the mailbox to list documents from. Obtain this ID from the List Mailboxes action. |
| `with_result` | boolean | No | If true, includes the full parsed result string in each document object. |
| `received_after` | string | No | Filter to include documents received on or after this date (YYYY-MM-DD). |
| `received_before` | string | No | Filter to include documents received on or before this date (YYYY-MM-DD). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 (Full Details)

**Slug:** `PARSEUR_LIST_MAILBOXES2`

Tool to list mailboxes (parsers) with full configuration details. Returns paginated list of all mailboxes with document counts, processing statistics, and complete configuration settings. Use when you need comprehensive mailbox information including field configurations, processing options, and webhook settings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (default is 1). |
| `search` | string | No | Case-insensitive partial match search to filter mailboxes by name or email prefix. |
| `ordering` | string ("name" | "-name" | "document_count" | "-document_count" | "template_count" | "-template_count" | "PARSEDOK_count" | "-PARSEDOK_count" | "PARSEDKO_count" | "-PARSEDKO_count" | "QUOTAEXC_count" | "-QUOTAEXC_count" | "EXPORTKO_count" | "-EXPORTKO_count" | "TRANSKO_count" | "-TRANSKO_count") | No | Ordering options for mailbox list. |
| `page_size` | integer | No | Number of results per page (default is 25, maximum 100). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 for Mailbox

**Slug:** `PARSEUR_LIST_TEMPLATES`

Tool to list all templates in a given mailbox. Use after fetching mailbox details when you need to page through and inspect available templates for further actions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (pagination). Defaults to 1. |
| `search` | string | No | Filter templates whose name contains this string (case-insensitive). |
| `ordering` | string ("name" | "-name" | "created" | "-created" | "modified" | "-modified" | "last_activity" | "-last_activity" | "status" | "-status" | "document_count" | "-document_count") | No | Field to sort by. Prepend a minus to reverse order. Supported: name, created, modified, last_activity, status, document_count. |
| `page_size` | integer | No | Number of items per page. Defaults to 25. |
| `mailbox_id` | string | Yes | The numeric ID of the mailbox (parser) to list templates for. Obtain this from the List Mailboxes action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 for Mailbox

**Slug:** `PARSEUR_LIST_WEBHOOKS`

Tool to list all webhooks for a mailbox. Use when you need to retrieve both active and paused webhooks for a given mailbox.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mailbox_id` | string | Yes | The unique identifier (numeric ID) of the mailbox whose webhooks you want to list. Obtain this from the List Mailboxes action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 |

### Reprocess a document

**Slug:** `PARSEUR_REPROCESS_DOCUMENT`

Tool to reprocess a document. Triggers re-parsing of the document with the current template configuration. Use when you need to re-parse a document after template updates or to retry failed parsing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `document_id` | string | Yes | Unique identifier of the document to reprocess. Obtain this ID from the List Documents action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 |

### Retrieve a webhook

**Slug:** `PARSEUR_RETRIEVE_WEBHOOK`

Tool to retrieve details of a specific webhook. Use after creating or listing webhooks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_id` | string | Yes | Unique identifier of the webhook to retrieve. Obtain from list webhooks or create webhook responses. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 a document

**Slug:** `PARSEUR_SKIP_DOCUMENT`

Tool to skip a document. Marks the document as skipped and returns the updated document with status 'SKIPPED'.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the document to skip. Obtain this ID from list documents or document processing responses. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 custom download

**Slug:** `PARSEUR_UPDATE_CUSTOM_DOWNLOAD`

Tool to update a custom download (export configuration) for a mailbox. Use when you need to modify the field list, name, or export settings for an existing download configuration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Unique identifier of the export configuration to update |
| `name` | string | No | Display name for the export configuration |
| `type` | string ("PARSER" | "PARSER_FIELD") | No | Type of export configuration. Use 'PARSER' for full parser exports or 'PARSER_FIELD' for field-specific exports |
| `items` | array | No | List of field names to include in the export |
| `mailbox_id` | string | Yes | Unique identifier of the mailbox (parser) containing the export configuration |
| `parser_field_id` | string | No | Parser field ID starting with 'PF', required when type is 'PARSER_FIELD' |
| `parser_field_name` | string | No | Name of the parser field, used when type is 'PARSER_FIELD' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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

**Slug:** `PARSEUR_UPDATE_MAILBOX`

Tool to update a mailbox (parser) configuration. Use when you need to modify mailbox settings such as name, AI engine, processing options, or document handling rules.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The ID of the parser/mailbox to update |
| `name` | string | No | The name of the parser |
| `ai_engine` | string ("DISABLED" | "GCP_AI_1" | "GCP_AI_2" | "GCP_AI_2_5") | No | AI engine options for the mailbox. |
| `force_ocr` | boolean | No | Whether Parseur runs its own OCR on every document uploaded to this parser |
| `odd_pages` | boolean | No | Whether the parser is configured to process only odd page numbers in a document |
| `even_pages` | boolean | No | Whether the parser is configured to process only even page numbers in a document |
| `split_page` | integer | No | Number of pages to use for splitting documents. If set to 3, a 30-page document will be split into 10 files of 3 pages each |
| `disable_deskew` | boolean | No | Whether deskew is disabled for this parser (enabled by default) |
| `page_range_set` | array | No | The range of pages set to be processed in the parser |
| `split_keywords` | array | No | Keywords the parser will look for when splitting documents by page |
| `ai_instructions` | string | No | General AI instructions for this parser. Provide guidance for the AI engine on how to parse documents. |
| `default_timezone` | string | No | Default timezone for date parsing |
| `retention_policy` | integer | No | How many days documents and data are stored on servers before deletion (90 days is the default) |
| `decimal_separator` | string | No | Decimal separator to use for number parsing |
| `input_date_format` | string | No | Input date format for parsing dates |
| `allowed_extensions` | array | No | List of file extensions to process. If not present, all extensions will be enabled. |
| `master_parser_slug` | string ("invoices" | "statements" | "job-application" | "leads" | "resume-cv" | "food-delivery" | "search-alerts" | "real-estate" | "work-order" | "financial-statement" | "utility" | "contact-list" | "delivery-notes" | "property-bookings" | "job-search" | "travel" | "automotive" | "payslip" | "event-ticketing") | No | Master parser template slugs. |
| `process_attachments` | boolean | No | Whether email attachment processing is enabled on this parser |
| `split_page_range_set` | array | No | Specific page ranges to capture when splitting. Can have multiple values, e.g., 1,3-5,(1) |
| `identification_status` | string ("REQUESTED" | "PROGRESS" | "COMPLETED" | "MANUAL") | No | Identification status of the parser. |
| `attachments_only_override` | boolean | No | Use this to update whether the parser skips email processing and only processes attachments |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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:** `PARSEUR_UPDATE_WEBHOOK`

Tool to update an existing webhook’s settings. Use when you need to change the webhook’s target URL, event type, headers, or name after creation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Custom name for the webhook; defaults to the target URL if omitted |
| `event` | string ("document.processed" | "document.processed.flattened" | "document.template_needed" | "table.processed") | No | Trigger event for the webhook |
| `target` | string | No | HTTPS URL to receive the webhook payload |
| `headers` | object | No | Additional HTTP headers to include; Content-Type is always application/json |
| `webhook_id` | integer | Yes | Unique ID of the webhook to update |
| `parser_field` | string | No | ID of a specific field trigger in 'PF12345' format |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 Email Document

**Slug:** `PARSEUR_UPLOAD_EMAIL_DOCUMENT`

Tool to upload an email or text document to Parseur for parsing. Use when you need to programmatically send documents to a Parseur mailbox.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cc` | string | No | CC addresses (optional). |
| `to` | string | No | To addresses (optional). |
| `bcc` | string | No | BCC addresses (optional). |
| `from` | string | Yes | Sender name and email address. |
| `subject` | string | Yes | The title of your document, or email subject. |
| `body_html` | string | No | Document content as HTML (takes priority over plain text if both are provided). |
| `recipient` | string | Yes | Mailbox email address (e.g., test@in.parseur.com) where the document should be sent. |
| `body_plain` | string | No | Document content as plain text. |
| `message_headers` | array | No | Custom email headers as array of [key, value] pairs. Each pair must have exactly 2 elements. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | 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 |
