Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Handwrytten

Scalekit connector
Open markdown

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

Tools
47
What they doRead · write · destructive
28 · 12 · 728 read12 write7 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 Handwrytten connection

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

    Each user opens the link once and enters their Handwrytten 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
  • handwrytten_auth_checkCheck that the API key is valid.Read-only

    Check Authentication

    Check that the API key is valid. Returns the authentication status. Use it as a connection test; use handwrytten_user_get for account details.

    Inputs

    This tool takes no inputs.

  • handwrytten_basket_count_getCount the orders currently in the basket.Read-only

    Get Basket Count

    Count the orders currently in the basket. Returns the count. Use it before handwrytten_basket_send.

    Inputs

    This tool takes no inputs.

  • handwrytten_bundles_listList the bundles (packages shipped with orders) available to the account.Read-only

    List Bundles

    List the bundles (packages shipped with orders) available to the account. Returns bundle IDs and contents. Pass an ID as bundle_id when ordering.

    Inputs

    This tool takes no inputs.

  • handwrytten_card_dimensions_listList the card sizes and formats (flat or folded) for custom cards.Read-only

    List Card Dimensions

    List the card sizes and formats (flat or folded) for custom cards. Returns dimension IDs and sizes. Pass an ID as dimension_id to handwrytten_custom_card_create and handwrytten_preset_covers_list.

    Inputs

    This tool takes no inputs.

  • handwrytten_card_getGet one card by ID with its description, price, dimensions and images.Read-only

    Get Card

    Get one card by ID with its description, price, dimensions and images. Returns the card object. Get card IDs from handwrytten_cards_list.

    Inputs

    card_idintegerrequired
    ID of the card (stationery design) to use. Get card IDs from handwrytten_cards_list. Example: 3404.
    lowresboolean
    true returns low-resolution image URLs, which load faster. Example: true.
  • handwrytten_cards_by_category_listList the available cards grouped into category sections.Read-only

    List Cards by Category

    List the available cards grouped into category sections. Returns sections, each with its cards. Use handwrytten_cards_list for a flat list.

    Inputs

    category_idinteger
    Only return cards in this category. Get category IDs from handwrytten_categories_list. Example: 27.
    lowresboolean
    true returns low-resolution image URLs, which load faster. Example: true.
    pageinteger
    Page number of results, starting at 0. Example: 0.
    with_detailed_imagesboolean
    true includes the detailed (all sides) card image URLs in the response. Example: true.
    with_imagesboolean
    true includes card image URLs in the response. Example: true.
  • handwrytten_cards_listList the cards (stationery designs) available to the account, including custom cards, optionally for one category.Read-only

    List Cards

    List the cards (stationery designs) available to the account, including custom cards, optionally for one category. Returns card IDs, names, prices and image URLs. Use handwrytten_cards_by_category_list for cards grouped by category and handwrytten_card_get for one card.

    Inputs

    category_idinteger
    Only return cards in this category. Get category IDs from handwrytten_categories_list. Example: 27.
    lowresboolean
    true returns low-resolution image URLs, which load faster. Example: true.
    pageinteger
    Page number of results, starting at 0. Example: 0.
    with_detailed_imagesboolean
    true includes the detailed (all sides) card image URLs in the response. Example: true.
    with_imagesboolean
    true includes card image URLs in the response. Example: true.
  • handwrytten_categories_listList the card categories (for example Thank You, Birthday, Holiday).Read-only

    List Card Categories

    List the card categories (for example Thank You, Birthday, Holiday). Returns category IDs and names. Use the IDs to filter handwrytten_cards_list.

    Inputs

    This tool takes no inputs.