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
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. 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>Create the Parsio connection
In AgentKit > Connections, create a Parsio connection. The name you give it is the
connection_nameyour code passes. See Configure connections.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.actionsconst connector = 'parsio'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'parsio_mailboxes_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_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.actionsconnection_name = "parsio"identifier = "user_123"# Generate an authorization link for the userlink_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 callresult = actions.execute_tool(tool_input={},tool_name="parsio_mailboxes_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach 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 toexecute_toolparsio_collected_emails_listList the email addresses Parsio collected from documents in a mailbox (when collect_emails is on).Read-onlyList 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-onlyGet 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-onlyList 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-onlyGet 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-onlyList 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-onlyList 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-onlyList 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-onlyGet 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.
parsio_templates_listList the parsing templates of a template-based Parsio mailbox, page by page.Read-onlyList Templates
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.
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.
pageinteger- Page number, starting at 1. Example: 1.
parsio_webhook_getGet one Parsio webhook.Read-onlyGet Webhook
Get one Parsio webhook. Returns the webhook's name, url, event, enabled flag and table_id. Use parsio_webhooks_list to find the ID.
Inputs
webhook_idstringrequired- ID of the webhook. Example: 6487c4d2a9b3e40012347777.
parsio_webhooks_listList the webhooks of a Parsio mailbox.Read-onlyList Webhooks
List the webhooks of a Parsio mailbox. Returns webhooks with _id, name, url, event and enabled flag. Use parsio_webhook_get for one 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_document_createSend HTML or plain text to a template-based or GPT-powered Parsio mailbox and start parsing in the background.WriteImport Text Document
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.
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- Sender email address. Example: admin@example.com.
htmlstring- HTML content of the document. Give html or text; html wins when both are set. Example: <p>Order #1234 total $56.00</p>.
metaobject- Your own data, returned with the parsed result as __meta__. Example: {"external_id": "12345"}.
namestring- Document name or email subject. Example: New order.
textstring- Plain-text content of the document. Give html or text. Example: Order #1234 total $56.00.
tostring- Recipient email address. Example: me@example.com.
parsio_document_create_syncSend HTML or plain text to a template-based or GPT-powered Parsio mailbox and wait for the parsed result.WriteParse Text Document
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.
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- Sender email address. Example: admin@example.com.
htmlstring- HTML content of the document. Give html or text; html wins when both are set. Example: <p>Order #1234 total $56.00</p>.
metaobject- Your own data, returned with the parsed result as __meta__. Example: {"external_id": "12345"}.
namestring- Document name or email subject. Example: New order.
textstring- Plain-text content of the document. Give html or text. Example: Order #1234 total $56.00.
tostring- Recipient email address. Example: me@example.com.
parsio_document_reparseQueue a Parsio document to be parsed again, for example after changing templates.WriteReparse Document
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.
Inputs
document_idstringrequired- ID of the document. Example: 6487c2a8a9b3e40012345999.
parsio_documents_skipMark documents of a Parsio mailbox as skipped so they are not parsed or exported.WriteSkip Documents
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.
- Idempotent
Inputs
idsarrayrequired- IDs of the documents. Example: ["6487c2a8a9b3e40012345999"].
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_createCreate a Parsio mailbox (parser) of a given type.WriteCreate Mailbox
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.
Inputs
namestringrequired- Mailbox name. Example: Invoices.
has_raw_databoolean- Keep the raw document data.
ml_modelstring- OCR or AI model to use, depending on the mailbox type. Example: gpt-4o.
parse_sigboolean- Parse email signatures.
presetstring- 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.
parsio_mailbox_updateChange a Parsio mailbox's name, email prefix, attachment and email-collection settings, alerts or parser model.WriteUpdate Mailbox
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.
- Idempotent
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.
alert_email_hnumber- How often, in hours, to send email alerts. Example: 24.
collect_emailsboolean- Collect sender email addresses automatically.
email_prefixstring- Prefix of the mailbox's Parsio email address. Example: invoices-acme.
ml_modelstring- OCR or AI model to use, depending on the mailbox type. Example: gpt-4o.
namestring- New mailbox name. Example: Supplier invoices.
presetstring- 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_attachmentsboolean- true stores and parses email attachments, false ignores them.
receive_emailboolean- Whether the mailbox accepts incoming email.
parsio_templates_cloneCopy one or more Parsio templates into another mailbox.WriteClone Templates
Copy one or more Parsio templates into another mailbox. Returns the cloned templates. Use parsio_templates_list on the target mailbox to see them.
Inputs
idsarrayrequired- IDs of the templates. Example: ["6487c3b1a9b3e40012340001"].
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_templates_disableDisable one or more Parsio templates so they are no longer used for parsing.WriteDisable Templates
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.
- Idempotent
Inputs
idsarrayrequired- IDs of the templates. Example: ["6487c3b1a9b3e40012340001"].
parsio_templates_enableEnable one or more Parsio templates so they are used for parsing.WriteEnable Templates
Enable one or more Parsio templates so they are used for parsing. Returns the update result. Use parsio_templates_disable to turn them off.
- Idempotent
Inputs
idsarrayrequired- IDs of the templates. Example: ["6487c3b1a9b3e40012340001"].
parsio_webhook_createCreate a webhook that Parsio calls when documents in a mailbox are received, parsed or fail.WriteCreate Webhook
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.
Inputs
eventstringrequired- Event to send: doc.parsed, doc.parsed.flat (flattened data), doc.fail, doc.received or table.parsed.one of
doc.parseddoc.parsed.flatdoc.faildoc.receivedtable.parsed 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.
urlstringrequired- URL Parsio POSTs to. Example: https://example.com/parsio.
enabledboolean- Whether the webhook is active (default true).
namestring- Webhook name. Example: Send to CRM.
table_idstring- Table field ID; required only for table.parsed. Example: 6487c5e3a9b3e40012348888.
parsio_webhook_updateChange a Parsio webhook's name, URL, event, enabled flag or table.WriteUpdate Webhook
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.
- Idempotent
Inputs
webhook_idstringrequired- ID of the webhook to update. Example: 6487c4d2a9b3e40012347777.
enabledboolean- true activates, false pauses the webhook.
eventstring- Event to send: doc.parsed, doc.parsed.flat, doc.fail, doc.received or table.parsed.one of
doc.parseddoc.parsed.flatdoc.faildoc.receivedtable.parsed namestring- Webhook name. Example: Send to CRM.
table_idstring- Table field ID; required only for table.parsed. Example: 6487c5e3a9b3e40012348888.
urlstring- URL Parsio POSTs to. Example: https://example.com/parsio.
parsio_mailbox_deleteDelete a Parsio mailbox with its documents, templates and settings.DestructiveDelete Mailbox
Delete a Parsio mailbox with its documents, templates and settings. Returns the deletion result. Use parsio_mailboxes_list to find the ID.
- Idempotent
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_templates_deleteDelete one or more Parsio templates.DestructiveDelete Templates
Delete one or more Parsio templates. Returns the deletion result. Use parsio_templates_disable to stop using them without deleting.
- Idempotent
Inputs
idsarrayrequired- IDs of the templates. Example: ["6487c3b1a9b3e40012340001"].
parsio_webhooks_deleteDelete one or more Parsio webhooks.DestructiveDelete Webhooks
Delete one or more Parsio webhooks. Returns the deletion result. Use parsio_webhook_update with enabled false to pause instead.
- Idempotent
Inputs
idsarrayrequired- IDs of the webhooks. Example: ["6487c4d2a9b3e40012347777"].
No tools match.