> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Parsio

The Parsio connector lets your AI agent act in each user's Parsio account. Each user connects their own Parsio API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 25 tools.

**Authentication:** API Key
**Categories:** Files & Documents, Automation
**Tools:** 25: 11 read, 11 write, 3 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=PARSIO)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Parsio connection

   In **AgentKit > Connections**, create a Parsio connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'parsio'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Parsio:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'parsio_mailboxes_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "parsio"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Parsio:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="parsio_mailboxes_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Parsio credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'parsio_collected_emails_list',
  toolInput: {
    mailbox_id: '<mailbox_id>',
  },
  connector: 'parsio',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="parsio_collected_emails_list",
    tool_input={
        "mailbox_id": "<mailbox_id>",
    },
    connection_name="parsio",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `parsio_collected_emails_list`

List Collected Emails · Read-only

List the email addresses Parsio collected from documents in a mailbox (when collect_emails is on).
Returns the collected addresses.
Turn collection on with parsio_mailbox_update.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `mailbox_id` (`string`, required): ID of the Parsio mailbox (parser). Find it with parsio_mailboxes_list or in the browser address bar when the mailbox is open. Example: 6487c1f2a9b3e40012345678.

Example input: `{"mailbox_id":"<mailbox_id>"}`

### `parsio_document_get`

Get Document · Read-only

Get a Parsio document with its parsed data, in the same JSON shape Parsio webhooks send.
Returns the document's status, name, dates and parsed fields.
Use after parsio_document_create, or when parsio_document_create_sync returned parsing_in_progress true.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `document_id` (`string`, required): ID of the document (doc_id). Example: 6487c2a8a9b3e40012345999.

Example input: `{"document_id":"<document_id>"}`

### `parsio_documents_list`

List Documents · Read-only

List the documents in a Parsio mailbox, with paging, a date range, a name search and status filter.
Returns the documents with _id, name, status, content type and dates, plus paging totals.
Use parsio_document_get for one document's parsed data.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `mailbox_id` (`string`, required): ID of the Parsio mailbox (parser). Find it with parsio_mailboxes_list or in the browser address bar when the mailbox is open. Example: 6487c1f2a9b3e40012345678.
- `from` (`string`, optional): Only items from this date, YYYY-MM-DD. Example: 2026-11-01.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `per_page` (`integer`, optional): Documents per page, up to 500. Example: 100.
- `q` (`string`, optional): Only documents whose name contains this text. Example: invoice.
- `status` (`array`, optional): Only documents with these statuses, as shown in Parsio (for example parsed or fail). Example: ["parsed"].
- `to` (`string`, optional): Only items up to this date, YYYY-MM-DD. Example: 2026-11-16.

Example input: `{"mailbox_id":"<mailbox_id>"}`

### `parsio_mailbox_get`

Get Mailbox · Read-only

Get the settings and configuration of one Parsio mailbox.
Returns the mailbox with name, email prefix and address, parser type, model and processing settings.
Use parsio_mailboxes_list to find the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `mailbox_id` (`string`, required): ID of the Parsio mailbox (parser). Find it with parsio_mailboxes_list or in the browser address bar when the mailbox is open. Example: 6487c1f2a9b3e40012345678.

Example input: `{"mailbox_id":"<mailbox_id>"}`

### `parsio_mailbox_table_fields_list`

List Mailbox Table Fields · Read-only

List the table fields (columns of parsed tables) defined in a Parsio mailbox.
Returns the table fields with their ids and names.
Use a table field id as table_id when creating a table.parsed webhook.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `mailbox_id` (`string`, required): ID of the Parsio mailbox (parser). Find it with parsio_mailboxes_list or in the browser address bar when the mailbox is open. Example: 6487c1f2a9b3e40012345678.

Example input: `{"mailbox_id":"<mailbox_id>"}`

### `parsio_mailboxes_list`

List Mailboxes · Read-only

List all Parsio mailboxes (parsers) of the account.
Returns mailboxes with _id, name, email address, parser type and document counts.
Use parsio_mailbox_get for one mailbox's settings.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `parsio_parsed_data_list`

List Parsed Data · Read-only

Get the parsed data of the documents in a Parsio mailbox, page by page, optionally for a date range.
Returns the parsed fields of each document.
Use parsio_document_get for one document.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `mailbox_id` (`string`, required): ID of the Parsio mailbox (parser). Find it with parsio_mailboxes_list or in the browser address bar when the mailbox is open. Example: 6487c1f2a9b3e40012345678.
- `from` (`string`, optional): Only items from this date, YYYY-MM-DD. Example: 2026-11-01.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `to` (`string`, optional): Only items up to this date, YYYY-MM-DD. Example: 2026-11-16.

Example input: `{"mailbox_id":"<mailbox_id>"}`

### `parsio_template_get`

Get Template · Read-only

Get one Parsio parsing template.
Returns the template with its name, enabled flag, fields and sample document.
Use parsio_templates_list to find the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `template_id` (`string`, required): ID of the template. Example: 6487c3b1a9b3e40012340001.

Example input: `{"template_id":"<template_id>"}`

### `parsio_templates_list`

List Templates · Read-only

List the parsing templates of a template-based Parsio mailbox, page by page.
Returns templates with _id, name, enabled flag and dates.
Use parsio_template_get for one template.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `mailbox_id` (`string`, required): ID of the Parsio mailbox (parser). Find it with parsio_mailboxes_list or in the browser address bar when the mailbox is open. Example: 6487c1f2a9b3e40012345678.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.

Example input: `{"mailbox_id":"<mailbox_id>"}`

### `parsio_webhook_get`

Get Webhook · Read-only

Get one Parsio webhook.
Returns the webhook's name, url, event, enabled flag and table_id.
Use parsio_webhooks_list to find the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `webhook_id` (`string`, required): ID of the webhook. Example: 6487c4d2a9b3e40012347777.

Example input: `{"webhook_id":"<webhook_id>"}`

### `parsio_webhooks_list`

List Webhooks · Read-only

List the webhooks of a Parsio mailbox.
Returns webhooks with _id, name, url, event and enabled flag.
Use parsio_webhook_get for one webhook.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `mailbox_id` (`string`, required): ID of the Parsio mailbox (parser). Find it with parsio_mailboxes_list or in the browser address bar when the mailbox is open. Example: 6487c1f2a9b3e40012345678.

Example input: `{"mailbox_id":"<mailbox_id>"}`

### `parsio_document_create`

Import Text Document · Write

Send HTML or plain text to a template-based or GPT-powered Parsio mailbox and start parsing in the background.
Returns the new document's ID right away.
Get the result with parsio_document_get or a doc.parsed webhook; use parsio_document_create_sync to wait for it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `mailbox_id` (`string`, required): ID of the Parsio mailbox (parser). Find it with parsio_mailboxes_list or in the browser address bar when the mailbox is open. Example: 6487c1f2a9b3e40012345678.
- `from` (`string`, optional): Sender email address. Example: admin@example.com.
- `html` (`string`, optional): HTML content of the document. Give html or text; html wins when both are set. Example: Order #1234 total $56.00
.
- `meta` (`object`, optional): Your own data, returned with the parsed result as __meta__. Example: {"external_id": "12345"}.
- `name` (`string`, optional): Document name or email subject. Example: New order.
- `text` (`string`, optional): Plain-text content of the document. Give html or text. Example: Order #1234 total $56.00.
- `to` (`string`, optional): Recipient email address. Example: me@example.com.

Example input: `{"mailbox_id":"<mailbox_id>"}`

### `parsio_document_create_sync`

Parse Text Document · Write

Send HTML or plain text to a template-based or GPT-powered Parsio mailbox and wait for the parsed result.
Returns doc_id, status and the parsed json; if parsing is still running, parsing_in_progress is true and json is null.
If parsing_in_progress is true, fetch the result later with parsio_document_get; use parsio_document_create to not wait.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `mailbox_id` (`string`, required): ID of the Parsio mailbox (parser). Find it with parsio_mailboxes_list or in the browser address bar when the mailbox is open. Example: 6487c1f2a9b3e40012345678.
- `from` (`string`, optional): Sender email address. Example: admin@example.com.
- `html` (`string`, optional): HTML content of the document. Give html or text; html wins when both are set. Example: Order #1234 total $56.00
.
- `meta` (`object`, optional): Your own data, returned with the parsed result as __meta__. Example: {"external_id": "12345"}.
- `name` (`string`, optional): Document name or email subject. Example: New order.
- `text` (`string`, optional): Plain-text content of the document. Give html or text. Example: Order #1234 total $56.00.
- `to` (`string`, optional): Recipient email address. Example: me@example.com.

Example input: `{"mailbox_id":"<mailbox_id>"}`

### `parsio_document_reparse`

Reparse Document · Write

Queue a Parsio document to be parsed again, for example after changing templates.
Returns the queued status.
Fetch the new result with parsio_document_get.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `document_id` (`string`, required): ID of the document. Example: 6487c2a8a9b3e40012345999.

Example input: `{"document_id":"<document_id>"}`

### `parsio_documents_skip`

Skip Documents · Write

Mark documents of a Parsio mailbox as skipped so they are not parsed or exported.
Returns the update result.
Use parsio_documents_list to find document IDs.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ids` (`array`, required): IDs of the documents. Example: ["6487c2a8a9b3e40012345999"].
- `mailbox_id` (`string`, required): ID of the Parsio mailbox (parser). Find it with parsio_mailboxes_list or in the browser address bar when the mailbox is open. Example: 6487c1f2a9b3e40012345678.

Example input: `{"ids":["6487c2a8a9b3e40012345999"],"mailbox_id":"<mailbox_id>"}`

### `parsio_mailbox_create`

Create Mailbox · Write

Create a Parsio mailbox (parser) of a given type.
Returns the new mailbox with its _id and email address.
Send documents to it with parsio_document_create_sync or by email.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Mailbox name. Example: Invoices.
- `has_raw_data` (`boolean`, optional): Keep the raw document data.
- `ml_model` (`string`, optional): OCR or AI model to use, depending on the mailbox type. Example: gpt-4o.
- `parse_sig` (`boolean`, optional): Parse email signatures.
- `preset` (`string`, optional): Parser type or preset for the mailbox, as shown in Parsio's parser types (for example a template-based, GPT-powered or AI-powered parser, or an OCR converter). Example: gpt.

Example input: `{"name":"<name>"}`

### `parsio_mailbox_update`

Update Mailbox · Write

Change a Parsio mailbox's name, email prefix, attachment and email-collection settings, alerts or parser model. Only the fields you send change.
Returns the updated mailbox.
Use parsio_mailbox_get to read current settings.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `mailbox_id` (`string`, required): ID of the Parsio mailbox (parser). Find it with parsio_mailboxes_list or in the browser address bar when the mailbox is open. Example: 6487c1f2a9b3e40012345678.
- `alert_email_h` (`number`, optional): How often, in hours, to send email alerts. Example: 24.
- `collect_emails` (`boolean`, optional): Collect sender email addresses automatically.
- `email_prefix` (`string`, optional): Prefix of the mailbox's Parsio email address. Example: invoices-acme.
- `ml_model` (`string`, optional): OCR or AI model to use, depending on the mailbox type. Example: gpt-4o.
- `name` (`string`, optional): New mailbox name. Example: Supplier invoices.
- `preset` (`string`, optional): Parser type or preset for the mailbox, as shown in Parsio's parser types (for example a template-based, GPT-powered or AI-powered parser, or an OCR converter). Example: gpt.
- `process_attachments` (`boolean`, optional): true stores and parses email attachments, false ignores them.
- `receive_email` (`boolean`, optional): Whether the mailbox accepts incoming email.

Example input: `{"mailbox_id":"<mailbox_id>"}`

### `parsio_templates_clone`

Clone Templates · Write

Copy one or more Parsio templates into another mailbox.
Returns the cloned templates.
Use parsio_templates_list on the target mailbox to see them.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `ids` (`array`, required): IDs of the templates. Example: ["6487c3b1a9b3e40012340001"].
- `mailbox_id` (`string`, required): ID of the Parsio mailbox (parser). Find it with parsio_mailboxes_list or in the browser address bar when the mailbox is open. Example: 6487c1f2a9b3e40012345678.

Example input: `{"ids":["6487c3b1a9b3e40012340001"],"mailbox_id":"<mailbox_id>"}`

### `parsio_templates_disable`

Disable Templates · Write

Disable one or more Parsio templates so they are no longer used for parsing.
Returns the update result.
Use parsio_templates_enable to turn them back on.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ids` (`array`, required): IDs of the templates. Example: ["6487c3b1a9b3e40012340001"].

Example input: `{"ids":["6487c3b1a9b3e40012340001"]}`

### `parsio_templates_enable`

Enable Templates · Write

Enable one or more Parsio templates so they are used for parsing.
Returns the update result.
Use parsio_templates_disable to turn them off.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ids` (`array`, required): IDs of the templates. Example: ["6487c3b1a9b3e40012340001"].

Example input: `{"ids":["6487c3b1a9b3e40012340001"]}`

### `parsio_webhook_create`

Create Webhook · Write

Create a webhook that Parsio calls when documents in a mailbox are received, parsed or fail.
Returns the new webhook with its _id.
Use parsio_webhook_update to change or disable it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `event` (`string`, required): Event to send: doc.parsed, doc.parsed.flat (flattened data), doc.fail, doc.received or table.parsed. One of: `doc.parsed`, `doc.parsed.flat`, `doc.fail`, `doc.received`, `table.parsed`.
- `mailbox_id` (`string`, required): ID of the Parsio mailbox (parser). Find it with parsio_mailboxes_list or in the browser address bar when the mailbox is open. Example: 6487c1f2a9b3e40012345678.
- `url` (`string`, required): URL Parsio POSTs to. Example: https://example.com/parsio.
- `enabled` (`boolean`, optional): Whether the webhook is active (default true).
- `name` (`string`, optional): Webhook name. Example: Send to CRM.
- `table_id` (`string`, optional): Table field ID; required only for table.parsed. Example: 6487c5e3a9b3e40012348888.

Example input: `{"event":"doc.parsed","mailbox_id":"<mailbox_id>","url":"<url>"}`

### `parsio_webhook_update`

Update Webhook · Write

Change a Parsio webhook's name, URL, event, enabled flag or table. Only the fields you send change.
Returns the updated webhook.
Use parsio_webhook_get to read current values.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `webhook_id` (`string`, required): ID of the webhook to update. Example: 6487c4d2a9b3e40012347777.
- `enabled` (`boolean`, optional): true activates, false pauses the webhook.
- `event` (`string`, optional): Event to send: doc.parsed, doc.parsed.flat, doc.fail, doc.received or table.parsed. One of: `doc.parsed`, `doc.parsed.flat`, `doc.fail`, `doc.received`, `table.parsed`.
- `name` (`string`, optional): Webhook name. Example: Send to CRM.
- `table_id` (`string`, optional): Table field ID; required only for table.parsed. Example: 6487c5e3a9b3e40012348888.
- `url` (`string`, optional): URL Parsio POSTs to. Example: https://example.com/parsio.

Example input: `{"webhook_id":"<webhook_id>"}`

### `parsio_mailbox_delete`

Delete Mailbox · Destructive

Delete a Parsio mailbox with its documents, templates and settings.
Returns the deletion result.
Use parsio_mailboxes_list to find the ID.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `mailbox_id` (`string`, required): ID of the Parsio mailbox (parser). Find it with parsio_mailboxes_list or in the browser address bar when the mailbox is open. Example: 6487c1f2a9b3e40012345678.

Example input: `{"mailbox_id":"<mailbox_id>"}`

### `parsio_templates_delete`

Delete Templates · Destructive

Delete one or more Parsio templates.
Returns the deletion result.
Use parsio_templates_disable to stop using them without deleting.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `ids` (`array`, required): IDs of the templates. Example: ["6487c3b1a9b3e40012340001"].

Example input: `{"ids":["6487c3b1a9b3e40012340001"]}`

### `parsio_webhooks_delete`

Delete Webhooks · Destructive

Delete one or more Parsio webhooks.
Returns the deletion result.
Use parsio_webhook_update with enabled false to pause instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `ids` (`array`, required): IDs of the webhooks. Example: ["6487c4d2a9b3e40012347777"].

Example input: `{"ids":["6487c4d2a9b3e40012347777"]}`

## Related

Other Files & Documents connectors ([all 76](/agentkit/connectors/?category=files-documents)):

- [Notion](/agentkit/connectors/notion/): Scalekit connector, OAuth, 51 tools
- [Google Sheets](/agentkit/connectors/googlesheets/): Scalekit connector, OAuth, 48 tools
- [Google Drive](/agentkit/connectors/googledrive/): Scalekit connector, OAuth, 47 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
