Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Docsumo

Scalekit connector
Open markdown

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

Tools
30
What they doRead · write · destructive
16 · 10 · 416 read10 write4 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 Docsumo connection

    In AgentKit > Connections, create a Docsumo 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 = 'docsumo'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Docsumo:', 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: 'docsumo_account_get',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Docsumo 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
  • docsumo_account_getGet your Docsumo account details, monthly document usage and limits, and your active document types.Read-only

    Get Account And Document Types

    Get your Docsumo account details, monthly document usage and limits, and your active document types. Returns email, full name, user ID, usage and limits, and document types with their doc_type values. Use this to find doc_type values for docsumo_documents_list and folder creation.

    Inputs

    This tool takes no inputs.

  • docsumo_agents_listList the agents (document types and case types) in your Docsumo account.Read-only

    List Agents

    List the agents (document types and case types) in your Docsumo account. Returns agents with their IDs, names and kind. Use this to find a casetype_id for the case tools.

    Inputs

    typestring
    Which agents to list: all, doctype or casetype. Defaults to all. Example: casetype.one of alldoctypecasetype
  • docsumo_bank_statement_analytics_getGet analytics for a processed bank statement: spending, cash flow and other financial patterns.Read-only

    Get Bank Statement Analytics

    Get analytics for a processed bank statement: spending, cash flow and other financial patterns. Returns the analytics as JSON (or a CSV or XLSX export when output is set). Use mode all for the detailed report. Use docsumo_mca_analysis_run for merchant cash advance analysis across statements.

    Inputs

    doc_idstringrequired
    doc_id of a processed bank statement. Example: 40269200cd7443178dea03f8cccea8d4.
    modestring
    basic for a summary, all for the in-depth report. Defaults to basic. Example: basic.one of basicall
    outputstring
    Output format. Defaults to json. Example: json.one of jsoncsvxlsx
  • docsumo_case_getGet an overview of one case, optionally with its document types, fields, approvals, exports and documents.Read-only

    Get Case

    Get an overview of one case, optionally with its document types, fields, approvals, exports and documents. Returns the case's name, stage, assignee, workflow state and the sections requested in include. Use docsumo_cases_list to find case IDs.

    Inputs

    case_idstringrequired
    Case ID, from docsumo_cases_list. Example: case_73b2d9e1f4.
    casetype_idstringrequired
    Case type ID, from docsumo_agents_list. Example: ct_6a1f0c2e9b.
    includestring
    Comma-separated sections to include: doctypes, fields, approvals, exports, documents. Example: fields,documents.
  • docsumo_case_type_getGet the details of a case type: its stages, case fields and settings.Read-only

    Get Case Type

    Get the details of a case type: its stages, case fields and settings. Returns the case type with stage IDs and field IDs. Use this to find stage_id and case field IDs for docsumo_case_update and docsumo_cases_list.

    Inputs

    casetype_idstringrequired
    Case type ID, from docsumo_agents_list. Example: ct_6a1f0c2e9b.
  • docsumo_cases_listList the cases of a case type, filtered by stage, assignee, workflow state or dates, with pagination.Read-only

    List Cases

    List the cases of a case type, filtered by stage, assignee, workflow state or dates, with pagination. Returns cases with their IDs, names, stage, assignee, workflow state and timestamps. Use this to find a case_id. Use docsumo_case_get for one case.

    Inputs

    casetype_idstringrequired
    Case type ID, from docsumo_agents_list. Example: ct_6a1f0c2e9b.
    assigned_toarray
    Only cases assigned to these user IDs. Example: ["usr_51c2"]
    created_date_fromstring
    Created on or after this date, DD/MM/YYYY. Example: 01/10/2026.
    created_date_tostring
    Created on or before this date, DD/MM/YYYY. Example: 31/10/2026.
    limitinteger
    Cases per page, 0 to 100. Defaults to 20. Example: 20.
    modified_date_fromstring
    Modified on or after this date, DD/MM/YYYY. Example: 01/10/2026.
    modified_date_tostring
    Modified on or before this date, DD/MM/YYYY. Example: 31/10/2026.
    offsetinteger
    Cases to skip, for pagination. Defaults to 0. Example: 0.
    sort_bystring
    Sort field and direction. Defaults to created_date.desc. Example: modified_date.desc.one of created_date.asccreated_date.descmodified_date.ascmodified_date.desc
    stage_idarray
    Only cases in these stage IDs. Example: ["stg_review"]
    workflow_statearray
    Only cases in these workflow states. Example: ["completed"]
  • docsumo_document_data_getGet the data extracted from a document in simplified JSON: key-value fields and tables, whether extracted by Docsumo or corrected by a user.Read-only

    Get Extracted Data

    Get the data extracted from a document in simplified JSON: key-value fields and tables, whether extracted by Docsumo or corrected by a user. Returns the document's fields and table rows. Use this once a document is processed. Use docsumo_document_field_update to correct a value.

    Inputs

    doc_idstringrequired
    Docsumo document ID (doc_id), from docsumo_documents_list. Example: 40269200cd7443178dea03f8cccea8d4.
  • docsumo_document_getGet the metadata of one document, including its pages and page image URLs.Read-only

    Get Document

    Get the metadata of one document, including its pages and page image URLs. Returns doc_id, title, type, status, pages with image URLs, and timestamps. Use docsumo_document_data_get for the extracted field values.

    Inputs

    doc_idstringrequired
    Docsumo document ID (doc_id), from docsumo_documents_list. Example: 40269200cd7443178dea03f8cccea8d4.