Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Parsio

Scalekit connector
Open markdown

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.

Tools
25
What they doRead · write · destructive
11 · 11 · 311 read11 write3 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

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

  4. Authorize a user and make your first call

    quickstart.mts
    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)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Parsio credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • parsio_collected_emails_listList the email addresses Parsio collected from documents in a mailbox (when collect_emails is on).Read-only

    List Collected Emails

    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.

    Inputs

    mailbox_idstringrequired
    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.
  • parsio_document_getGet a Parsio document with its parsed data, in the same JSON shape Parsio webhooks send.Read-only

    Get Document

    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.

    Inputs

    document_idstringrequired
    ID of the document (doc_id). Example: 6487c2a8a9b3e40012345999.
  • parsio_documents_listList the documents in a Parsio mailbox, with paging, a date range, a name search and status filter.Read-only

    List Documents

    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.

    Inputs

    mailbox_idstringrequired
    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.
    fromstring
    Only items from this date, YYYY-MM-DD. Example: 2026-11-01.
    pageinteger
    Page number, starting at 1. Example: 1.
    per_pageinteger
    Documents per page, up to 500. Example: 100.
    qstring
    Only documents whose name contains this text. Example: invoice.
    statusarray
    Only documents with these statuses, as shown in Parsio (for example parsed or fail). Example: ["parsed"].
    tostring
    Only items up to this date, YYYY-MM-DD. Example: 2026-11-16.
  • parsio_mailbox_getGet the settings and configuration of one Parsio mailbox.Read-only

    Get Mailbox

    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.

    Inputs

    mailbox_idstringrequired
    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.
  • parsio_mailbox_table_fields_listList the table fields (columns of parsed tables) defined in a Parsio mailbox.Read-only

    List Mailbox Table Fields

    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.

    Inputs

    mailbox_idstringrequired
    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.
  • parsio_mailboxes_listList all Parsio mailboxes (parsers) of the account.Read-only

    List Mailboxes

    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.

    Inputs

    This tool takes no inputs.

  • parsio_parsed_data_listGet the parsed data of the documents in a Parsio mailbox, page by page, optionally for a date range.Read-only

    List Parsed Data

    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.

    Inputs

    mailbox_idstringrequired
    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.
    fromstring
    Only items from this date, YYYY-MM-DD. Example: 2026-11-01.
    pageinteger
    Page number, starting at 1. Example: 1.
    tostring
    Only items up to this date, YYYY-MM-DD. Example: 2026-11-16.
  • parsio_template_getGet one Parsio parsing template.Read-only

    Get Template

    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.

    Inputs

    template_idstringrequired
    ID of the template. Example: 6487c3b1a9b3e40012340001.