> **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 Handwrytten

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.

**Authentication:** API Key
**Categories:** Marketing, CRM & Sales
**Tools:** 47: 28 read, 12 write, 7 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=HANDWRYTTEN)

## 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 Handwrytten connection

   In **AgentKit > Connections**, create a Handwrytten 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 = '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)
   ```

   ```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 = "handwrytten"
   identifier = "user_123"

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

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

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Handwrytten 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: 'handwrytten_auth_check',
  toolInput: {},
  connector: 'handwrytten',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="handwrytten_auth_check",
    tool_input={},
    connection_name="handwrytten",
    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.

### `handwrytten_auth_check`

Check Authentication · Read-only

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

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

Inputs: none.

Example input: `{}`

### `handwrytten_basket_count_get`

Get Basket Count · Read-only

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

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

Inputs: none.

Example input: `{}`

### `handwrytten_bundles_list`

List Bundles · Read-only

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

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

Inputs: none.

Example input: `{}`

### `handwrytten_card_dimensions_list`

List Card Dimensions · Read-only

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.

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

Inputs: none.

Example input: `{}`

### `handwrytten_card_get`

Get Card · Read-only

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

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

Inputs:

- `card_id` (`integer`, required): ID of the card (stationery design) to use. Get card IDs from handwrytten_cards_list. Example: 3404.
- `lowres` (`boolean`, optional): true returns low-resolution image URLs, which load faster. Example: true.

Example input: `{"card_id":3404}`

### `handwrytten_cards_by_category_list`

List Cards by Category · Read-only

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

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

Inputs:

- `category_id` (`integer`, optional): Only return cards in this category. Get category IDs from handwrytten_categories_list. Example: 27.
- `lowres` (`boolean`, optional): true returns low-resolution image URLs, which load faster. Example: true.
- `page` (`integer`, optional): Page number of results, starting at 0. Example: 0.
- `with_detailed_images` (`boolean`, optional): true includes the detailed (all sides) card image URLs in the response. Example: true.
- `with_images` (`boolean`, optional): true includes card image URLs in the response. Example: true.

Example input: `{}`

### `handwrytten_cards_list`

List Cards · Read-only

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.

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

Inputs:

- `category_id` (`integer`, optional): Only return cards in this category. Get category IDs from handwrytten_categories_list. Example: 27.
- `lowres` (`boolean`, optional): true returns low-resolution image URLs, which load faster. Example: true.
- `page` (`integer`, optional): Page number of results, starting at 0. Example: 0.
- `with_detailed_images` (`boolean`, optional): true includes the detailed (all sides) card image URLs in the response. Example: true.
- `with_images` (`boolean`, optional): true includes card image URLs in the response. Example: true.

Example input: `{}`

### `handwrytten_categories_list`

List Card Categories · Read-only

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

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

Inputs: none.

Example input: `{}`

### `handwrytten_countries_list`

List Countries · Read-only

List the countries cards can be sent to. Returns country IDs and names. Use the IDs as country_id in address tools and handwrytten_states_list.

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

Inputs: none.

Example input: `{}`

### `handwrytten_custom_image_quality_check`

Check Custom Image Quality · Read-only

Check whether an uploaded image is sharp enough to print, optionally on a given card. Returns the quality verdict. Get image IDs from handwrytten_custom_images_list.

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

Inputs:

- `image_id` (`integer`, required): ID of an uploaded custom image. Get IDs from handwrytten_custom_images_list. Example: 4410.
- `card_id` (`integer`, optional): ID of the card (stationery design) to use. Get card IDs from handwrytten_cards_list. Example: 3404.

Example input: `{"image_id":4410}`

### `handwrytten_custom_images_list`

List Custom Images · Read-only

List the logo and cover images uploaded to the account, optionally only one type. Returns image IDs and URLs. Use the IDs with handwrytten_custom_card_create; images are uploaded in the Handwrytten app.

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

Inputs:

- `type` (`string`, optional): Kind of record: for images, logo or cover; for prospecting, residential or business. Example: logo. One of: `logo`, `cover`.

Example input: `{}`

### `handwrytten_default_sender_address_get`

Get Default Sender Address · Read-only

Get the account's default sender (return) address. Returns the address object. Use handwrytten_sender_addresses_list for all of them.

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

Inputs: none.

Example input: `{}`

### `handwrytten_fonts_list`

List Fonts · Read-only

List the handwriting styles available for messages. Returns each font's ID, label and preview. Pass the label to handwrytten_order_single_step_create (font_label) or the ID to handwrytten_basket_order_add (font).

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

Inputs: none.

Example input: `{}`

### `handwrytten_gift_cards_list`

List Gift Cards · Read-only

List the gift cards that can be enclosed with a card. Returns gift cards with their denomination IDs and amounts. Pass a denomination ID as denomination_id when ordering.

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

Inputs: none.

Example input: `{}`

### `handwrytten_inserts_list`

List Inserts · Read-only

List the custom inserts (printed material enclosed with cards) on the account. Returns insert IDs, names and stock. Pass an ID as insert_id when ordering.

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

Inputs:

- `include_historical` (`boolean`, optional): If true, includes inserts that are out of stock. Example: true.

Example input: `{}`

### `handwrytten_order_get`

Get Order · Read-only

Get one order by ID with its card, message, recipient, status and price. Returns the order object. Use it to track an order created with handwrytten_order_single_step_create or the basket tools.

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

Inputs:

- `order_id` (`integer`, required): ID of the order to get. Example: 305578.

Example input: `{"order_id":305578}`

### `handwrytten_preset_covers_list`

List Preset Covers · Read-only

List the preset cover images for a card dimension. Returns preset cover IDs and image URLs. Use an ID as preset_cover_id in handwrytten_custom_card_create.

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

Inputs:

- `dimension_id` (`integer`, required): Card dimension ID. See /design/dimensions for available options. Example: 1.

Example input: `{"dimension_id":1}`

### `handwrytten_prospecting_order_preview`

Preview Prospecting Order · Read-only

Price a prospecting campaign: a card and message sent to a number of prospects. Returns the price breakdown without placing an order. Use handwrytten_prospecting_order_add to add the campaign to the basket.

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

Inputs:

- `card_id` (`integer`, required): ID of the card (stationery design) to use. Get card IDs from handwrytten_cards_list. Example: 3404.
- `country` (`string`, required): Country for prospecting: United States or Canada. Example: United States.
- `message` (`string`, required): The handwritten message text. Use \n for new lines. Example: Dear Frank,\nThank you so much for your business.
- `records` (`integer`, required): Number of prospects (cards) to send. Example: 5.
- `return_address_id` (`integer`, required): ID of the sender (return) address. Get IDs from handwrytten_sender_addresses_list. Example: 88123.
- `insert_id` (`integer`, optional): ID of a custom insert to enclose with the card. Get IDs from handwrytten_inserts_list. Example: 51.
- `must_deliver_by` (`string`, optional): Date the cards must arrive by, in MM/DD/YYYY format. Example: 03/15/2026.
- `shipping_address_id` (`integer`, optional): ID of the address to ship the cards to when they are not mailed directly. Get IDs from handwrytten_sender_addresses_list. Example: 88123.
- `shipping_method_id` (`integer`, optional): Shipping method. - 1: Mail Normally - 2: Ship: Address, Seal, Stamp - 3: Ship: Cards Only (no envelope) - 4: Ship: Cards Only (blank envelope unsealed) - 5: Ship: Addressed & Unsealed - 6: Ship: Addressed & Sealed. Example: 1. One of: `1`, `2`, `3`, `4`, `5`, `6`.
- `shipping_rate_id` (`integer`, optional): Shipping rate. - 1: Ground - 2: 2-Day - 3: Overnight - 4: Overnight Priority. Example: 1. One of: `1`, `2`, `3`, `4`.

Example input: `{"card_id":3404,"country":"<country>","message":"<message>","records":5,"return_address_id":88123}`

### `handwrytten_prospecting_targets_calculate`

Calculate Prospecting Targets · Read-only

Count the residential or business prospects around an address within a radius, filtered by demographics (home ownership, income, age and more) or business size and industry. Returns the number of matching targets. Use it before handwrytten_prospecting_order_preview and handwrytten_prospecting_order_add.

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

Inputs:

- `address` (`string`, required): Street address to serve as a central point for prospecting search. Example: 9280 South Kyrene Road.
- `city` (`string`, required): City. For prospecting tools use the format STATE;City, for example AZ;Tempe. Example: Phoenix.
- `country` (`string`, required): Country for prospecting: United States or Canada. Example: United States.
- `radius` (`integer`, required): Search radius in miles from the central point. Example: 5.
- `type` (`string`, required): Kind of record: for images, logo or cover; for prospecting, residential or business. Example: residential. One of: `residential`, `business`.
- `zip` (`string`, required): ZIP or postal code. Example: 85004.
- `h_age` (`string`, optional): Household age for residential search. - 1: 18-24 years old - 2: 25-34 years old - 3: 35-44 years old - 4: 45-54 years old - 5: 55-64 years old - 6: 65-74 years old - 7: 75+ years old If you want to use multiple values, use dash to separate them, for example: "hAge-d": "1-3-4-5". Example: 2-3.
- `hinc_d` (`string`, optional): Household income for residential search. - 1: Less than $14,999 - 2: $15,000 - $19,999 - 3: $20,000 - $29,999 - 4: $30,000 - $39,999 - 5: $40,000 - $49,999 - 6: $50,000 - $74,999 - 7: $75,000 - $99,999 - 8: $100,000 - $124,999 - 9: $125,000 - $149,999 - 10: $150,000 - $174,999 - 11: $175,000 - $199,999 - 12: $200,000 - $249,999 - 13: $250,000 or more If you want to use multiple values, use dash to separate them, for example: "hinc-d": "2-3-4-5-6". Example: 5-6.
- `home_d` (`string`, optional): Home value for residential search. - 1: $1 - $49,999 - 2: $50,000 - $99,999 - 3: $100,000 - $149,999 - 4: $150,000 - $199,999 - 5: $200,000 - $249,999 - 6: $250,000 - $299,999 - 7: $300,000 - $349,999 - 8: $350,000 - $399,999 - 9: $400,000 - $449,999 - 10: $450,000 - $499,999 - 11: $500,000 - $574,999 - 12: $575,000 - $649,999 - 13: $650,000 - $724,999 - 14: $725,000 - $799,999 - 15: $800,000 - $899,999 - 16: $900,000 - $999,999 - 17: $1,000,000 - $1,999,999 - 18: $2,000,000 or More If you want to use multiple values, use dash to separate them, for example: "Home-d": "3-4-5-8-9". Example: 3-4.
- `kids` (`string`, optional): Children in household for residential search. - 1: 1 child - 2: 2 children - 3: 3 children - 4: 4 children - 5: 5 children - 6: 6 Children - 7: 7 children - 8: 8 children - 9: 9+ children If you want to use multiple values, use dash to separate them, for example: "kids-d": "4-7-8-5". Example: 1.
- `latitude` (`string`, optional): Latitude to serve as a central point for prospecting search. If not using latitude and longitude, set them to 1. We use them for a secondary search if nothing was found at the address. Example: 1.
- `longitude` (`string`, optional): Longitude to serve as a central point for prospecting search. If not using latitude and longitude, set them to 1. We use them for a secondary search if nothing was found at the address. Example: 1.
- `marital` (`string`, optional): Marital status for residential search. - 1: Unknown - 2: Household contains at least 1 married person - 3: Household contains at least 1 single person - 4: Household contains both married & single persons If you want to use multiple values, use dash to separate them, for example: "marital-d": "1-2". Example: 2.
- `one` (`string`, optional): Return all or one contact per business. - 0: Return all contacts - 1: Return one contact. Example: 0. One of: `0`, `1`.
- `own_rent_d` (`string`, optional): Home ownership for residential search. - 1: Home owner - 2: Renter If you want to use multiple values, use dash to separate them, for example: "ownRent-d": "1-2". Example: 1.
- `people` (`string`, optional): People in household for residential search. - 1: 1 person - 2: 2 persons - 3: 3 persons - 4: 4 persons - 5: 5 persons - 6: 6 persons - 7: 7 persons - 8: 8 persons - 9: 9+ persons If you want to use multiple values, use dash to separate them, for example: "people-d": "4-5". Example: 2.
- `res_len_d` (`string`, optional): Length of residency for residential search. - 1: 0-6 months - 2: 7-12 months - 3: 1-2 years - 4: 3-5 years - 5: 6-10 years - 6: 11-15 years - 7: 16-20 years - 8: 20+ years If you want to use multiple values, use dash to separate them, for example: "resLen-d": "1-3-4-5-8". Example: 1-2.
- `sale` (`string`, optional): Annual sales volume for business search. - 1: $1,000 - $499,999 - 2: $500,000 - $999,999 - 3: $1,000,000 - $2,499,999 - 4: $2,500,000 - $4,999,999 - 5: $5,000,000 - $9,999,999 - 6: $10,000,000 - $19,999,999 - 7: $20,000,000 - $49,999,999 - 8: $50,000,000 - $99,999,999 - 9: $100,000,000 - $499,999,999 - 10: $500,000,000 - $999,999,999 - 11: Over $1 billion If you want to use multiple values, use dash to separate them, for example: "sale-d": "6-7-8". Example: 1-2.
- `sic` (`string`, optional): Industry code for business search. Use dash to separate multiple codes, for example: "sic": "17-9999-729924". Example: 17-9999.
- `staff` (`string`, optional): Staff size for business search. - 1: 1 - 4 - 2: 5 - 9 - 3: 10 - 19 - 4: 20 - 49 - 5: 50 - 99 - 6: 100 - 249 - 7: 250 - 499 - 8: 500 - 999 - 9: 1,000 - 4,999 - 10: 5,000 - 9,999 - 11: 10,000 + If you want to use multiple values, use dash to separate them, for example: "staff-d": "2-6-8". Example: 2-3.
- `worth_d` (`string`, optional): Net worth for residential search. - 1: Less than $25,000 - 2: $25,000 - $49,999 - 3: $50,000 - $74,999 - 4: $75,000 - $99,999 - 5: $100,000 - $149,999 - 6: $150,000 - $249,999 - 7: $250,000 - $499,999 - 8: $500,000 - $749,999 - 9: $750,000 - $999,999 - 10: $1,000,000 or more If you want to use multiple values, use dash to separate them, for example: "worth-d": "6-8-9". Example: 4-5.

Example input: `{"address":"<address>","city":"<city>","country":"<country>","radius":5,"type":"residential","zip":"<zip>"}`

### `handwrytten_qr_code_frames_list`

List QR Code Frames · Read-only

List the decorative frames available around QR codes. Returns frame IDs and previews. Use an ID as qr_code_frame_id in handwrytten_custom_card_create.

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

Inputs: none.

Example input: `{}`

### `handwrytten_qr_code_stats_get`

Get QR Code Statistics · Read-only

Get scan statistics for the account's QR codes. Returns scan counts per code. Use handwrytten_qr_codes_list for the codes themselves.

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

Inputs: none.

Example input: `{}`

### `handwrytten_qr_codes_list`

List QR Codes · Read-only

List the QR codes created on the account. Returns QR code IDs, names and target URLs. Use an ID as qr_code_id in handwrytten_custom_card_create.

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

Inputs: none.

Example input: `{}`

### `handwrytten_recipients_list`

List Recipient Addresses · Read-only

List the recipient addresses saved in the address book. Returns address IDs, names and addresses. Use the IDs as address_id or address_ids in handwrytten_basket_order_add.

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

Inputs: none.

Example input: `{}`

### `handwrytten_sender_addresses_list`

List Sender Addresses · Read-only

List the sender (return) addresses saved on the account. Returns address IDs and addresses. Use an ID as return_address_id when ordering; use handwrytten_default_sender_address_get for the default one.

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

Inputs: none.

Example input: `{}`

### `handwrytten_signatures_list`

List Signatures · Read-only

List the custom handwritten signatures saved on the account. Returns signature IDs and previews. Use the IDs with handwrytten_prospecting_order_add.

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

Inputs: none.

Example input: `{}`

### `handwrytten_stamp_options_list`

List Stamp Options · Read-only

List the stamp options for US orders. Returns option IDs, names and prices. Pass an ID as stamp_option_id when ordering.

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

Inputs: none.

Example input: `{}`

### `handwrytten_states_list`

List States · Read-only

List the states or provinces of a country. Returns state codes and names. Get country IDs from handwrytten_countries_list (1 is the United States).

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

Inputs:

- `country_id` (`integer`, required): Handwrytten country ID: 1 is the United States, 2 is Canada. Get other IDs from handwrytten_countries_list. Example: 1.

Example input: `{"country_id":1}`

### `handwrytten_user_get`

Get User · Read-only

Get the account behind the API key: name, email, credit balance, test-mode flag and default settings. Returns the user object. Use it to check the credit balance or confirm which account is connected.

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

Inputs: none.

Example input: `{}`

### `handwrytten_basket_order_add`

Add Order to Basket · Write

Add an order for a card to the basket without paying, for one saved address (address_id), several (address_ids) or inline addresses with per-recipient messages (addresses). Returns the basket order IDs. Use handwrytten_basket_send to pay for and submit everything in the basket. Get card IDs from handwrytten_cards_list and font IDs from handwrytten_fonts_list.

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

Inputs:

- `card_id` (`integer`, required): ID of the card (stationery design) to use. Get card IDs from handwrytten_cards_list. Example: 3404.
- `address_id` (`integer`, optional): ID of the saved address to act on. Get recipient IDs from handwrytten_recipients_list and sender IDs from handwrytten_sender_addresses_list. Example: 90211.
- `address_ids` (`array`, optional): IDs of several saved recipient addresses to send the card to, one order each. Use instead of address_id or addresses. Get IDs from handwrytten_recipients_list. Example: [90211, 90212]
- `addresses` (`array`, optional): Required if address_ids is not present, for bulk order, from bulk_address_parse_xls request. Contains both the addresses and the message to send. Example: [{"first_name": "Frank", "last_name": "Jones", "address1": "1600 Main Street", "city": "Phoenix", "state": "AZ", "zip": "85004", "country_id": 1, "message": ...
- `auto_font_size` (`boolean`, optional): true lets Handwrytten shrink the font so a long message fits the card. Example: true.
- `bundle_id` (`integer`, optional): Bundle to ship with the order. Use GET /bundles/list to fetch the available bundles. Example: 7.
- `check_quantity` (`boolean`, optional): check cards and inserts quantity in stock, return insufficient quantity error in case of low stock. Example: true.
- `client_metadata` (`string`, optional): Your own reference stored with the order and returned in order details and webhooks, such as a CRM contact ID. Example: crm-contact-48213.
- `coupon_code` (`string`, optional): Coupon code to apply to the order price. Example: SPRING10.
- `delivery_confirmation` (`integer`, optional): Delivery confirmation option for the order: 0 — none, 1 — delivery confirmation, 2 — CASS validation only. Example: 0. One of: `0`, `1`, `2`.
- `denomination_id` (`integer`, optional): Gift card denomination ID to enclose with the card. Get IDs from handwrytten_gift_cards_list. Example: 12.
- `font` (`string`, optional): Handwriting font ID (slug) for the message, such as hwDavid. Get IDs from handwrytten_fonts_list. Example: hwDavid.
- `font_size` (`integer`, optional): Font size in points for the handwritten message. Leave empty for the default size. Example: 13.
- `for_free` (`boolean`, optional): true to place the order without charge where the account allows free orders (for example promotional credit). Usually leave empty. Example: true.
- `insert_id` (`integer`, optional): ID of a custom insert to enclose with the card. Get IDs from handwrytten_inserts_list. Example: 51.
- `quantity` (`integer`, optional): Number of identical cards to send to each recipient. Defaults to 1. Example: 1.
- `return_address_id` (`integer`, optional): ID of the sender (return) address. Get IDs from handwrytten_sender_addresses_list. Example: 88123.
- `stamp_option_id` (`integer`, optional): Stamp option to use. Applies to US orders; ignored for international. Use GET /shipping/stampOptions to fetch the available options. Example: 2.

Example input: `{"card_id":3404}`

### `handwrytten_basket_send`

Send Basket · Write

Pay for and submit every order currently in the basket, using account credit first and then the card on file or credit_card_id. Returns the submitted order IDs and charges. Orders spend account credit or charge a card unless the account is in test mode (handwrytten_test_mode_set). Add orders first with handwrytten_basket_order_add or handwrytten_prospecting_order_add.

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

Inputs:

- `check_quantity` (`boolean`, optional): check cards and inserts quantity in stock, return insufficient quantity error in case of low stock. Example: true.
- `coupon_code` (`string`, optional): Coupon code to apply to the order price. Example: SPRING10.
- `credit_card_id` (`integer`, optional): If provided, it is the id number of the credit card on file to be charged. Example: 34124.
- `notes` (`object`, optional): dictionary of order notes, order id is used as a key. Example: {"196936": "Deliver before the holidays"}
- `price_structure` (`object`, optional): Expected structure price by types of payment. If the structure does not match during the calculation, an error will be returned. Example: {"credit": 3.25}

Example input: `{}`

### `handwrytten_custom_card_create`

Create or Update Custom Card · Write

Create a custom card from uploaded or preset covers plus header, footer, inside and back text or logos; with is_update true and card_id it updates an existing custom card. Returns the card ID. Get dimension IDs from handwrytten_card_dimensions_list, images from handwrytten_custom_images_list and fonts from handwrytten_fonts_list.

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

Inputs:

- `name` (`string`, required): Name to save the record under. Example: Frank Jones.
- `back_align` (`string`, optional): Horizontal alignment of the back content: left, center or right. Example: left. One of: `left`, `center`, `right`.
- `back_cover_id` (`integer`, optional): ID of an uploaded cover image (type: cover) for the back surface. Example: 4409.
- `back_font_color` (`string`, optional): Hex color of the back text, such as #000000. Example: #000000.
- `back_font_id` (`integer`, optional): Font ID for the back text. See /fonts/listForCustomizer. Example: 1.
- `back_font_size` (`integer`, optional): Font size of the back text in points. Example: 16.
- `back_logo_id` (`integer`, optional): ID of the logo image (type: logo) for the back. Used when back_type is 'logo'. Example: 4410.
- `back_size_percent` (`integer`, optional): Size of the back logo as a percentage of the surface. Example: 24.
- `back_text` (`string`, optional): Back text. Used when back_type is 'text'. Example: 123.
- `back_type` (`string`, optional): What the back surface shows: text or logo. Example: text. One of: `text`, `logo`.
- `back_vertical_align` (`string`, optional): Vertical alignment on the back surface: top, center or bottom. Example: top. One of: `top`, `center`, `bottom`.
- `card_id` (`integer`, optional): ID of the card (stationery design) to use. Get card IDs from handwrytten_cards_list. Example: 3404.
- `cover_id` (`integer`, optional): ID of the uploaded cover image (type: cover) to use as the front of the card. Example: 4409.
- `cover_size_percent` (`integer`, optional): Size of the cover image as a percentage of the card front. Example: 84.
- `dimension_id` (`integer`, optional): Card size and format. See /cards/listDimensions for available options. Example: 1.
- `footer_align` (`string`, optional): Horizontal alignment of the footer content: left, center or right. Example: left. One of: `left`, `center`, `right`.
- `footer_font_color` (`string`, optional): Hex color of the footer text, such as #000000. Example: #000000.
- `footer_font_id` (`integer`, optional): Font ID for the footer text. See /fonts/listForCustomizer. Example: 1.
- `footer_font_size` (`integer`, optional): Font size of the footer text in points. Example: 16.
- `footer_logo_id` (`integer`, optional): ID of the logo image (type: logo) for the footer. Used when footer_type is 'logo'. Example: 4410.
- `footer_logo_size_percent` (`integer`, optional): Size of the footer logo as a percentage of its area. Example: 50.
- `footer_text` (`string`, optional): Footer text. Used when footer_type is 'text'. Example: footer text.
- `footer_type` (`string`, optional): Whether the footer uses text or a logo image. Example: text. One of: `text`, `logo`.
- `header_align` (`string`, optional): Horizontal alignment of the header content: left, center or right. Example: left. One of: `left`, `center`, `right`.
- `header_font_color` (`string`, optional): Hex color of the header text, such as #000000. Example: #000000.
- `header_font_id` (`integer`, optional): Font ID for the header text. See /fonts/listForCustomizer. Example: 1.
- `header_font_size` (`integer`, optional): Font size of the header text in points. Example: 16.
- `header_logo_id` (`integer`, optional): ID of the logo image (type: logo) for the header. Used when header_type is 'logo'. Example: 4410.
- `header_logo_size_percent` (`integer`, optional): Size of the header logo as a percentage of its area. Example: 50.
- `header_text` (`string`, optional): Header text. Used when header_type is 'text'. Example: Header text.
- `header_type` (`string`, optional): Whether the header uses text or a logo image. Foldable cards only. Example: text. One of: `text`, `logo`.
- `is_update` (`boolean`, optional): Set to true to update an existing custom card. Must be combined with card_id. Example: false.
- `main_align` (`string`, optional): Horizontal alignment of the inside top content: left, center or right. Example: left. One of: `left`, `center`, `right`.
- `main_font_color` (`string`, optional): Hex color of the inside top text, such as #000000. Example: #000000.
- `main_font_id` (`integer`, optional): Font ID for the inside top text. See /fonts/listForCustomizer. Example: 1.
- `main_font_size` (`integer`, optional): Font size of the inside top text in points. Example: 50.
- `main_logo_id` (`integer`, optional): ID of the logo image (type: logo) for the inside top. Used when main_type is 'logo'. Example: 4410.
- `main_logo_size_percent` (`integer`, optional): Size of the inside top logo as a percentage of its area. Example: 50.
- `main_text` (`string`, optional): Inside top text. Used when main_type is 'text'. Example: Thank you for choosing us!.
- `main_type` (`string`, optional): Content type for the inside top surface. Foldable cards only. Example: text. One of: `text`, `logo`.
- `preset_back_cover_id` (`integer`, optional): ID of a preset cover for the back surface. See /cards/listPresetCovers. Example: 12.
- `preset_cover_id` (`integer`, optional): ID of a preset cover to use instead of a custom uploaded image. See /cards/listPresetCovers. Example: 12.
- `qr_code_align` (`string`, optional): Horizontal alignment of the QR code: left, center or right. Example: left. One of: `left`, `center`, `right`.
- `qr_code_frame_id` (`integer`, optional): ID of the QR code frame. See /qrCode/frames for available frames. Example: 3.
- `qr_code_id` (`integer`, optional): ID of the QR code to include. See /qrCode for available QR codes. Example: 234.
- `qr_code_location` (`string`, optional): Where the QR code goes: header or footer. Example: header. One of: `header`, `footer`.
- `qr_code_size_percent` (`integer`, optional): Size of the QR code as a percentage of its area. Example: 20.

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

### `handwrytten_default_sender_address_set`

Set Default Sender Address · Write

Make a saved sender address the account default. Returns the result. Get address IDs from handwrytten_sender_addresses_list.

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

Inputs:

- `address_id` (`integer`, required): ID of the sender address to make the default. Get it from handwrytten_sender_addresses_list. Example: 88123.

Example input: `{"address_id":88123}`

### `handwrytten_order_single_step_create`

Send Single Card Order · Write

Create and submit one handwritten card order in a single call, giving the card, font, message, sender and recipient addresses. Returns the order ID and status. Use it for one card to one recipient; use handwrytten_basket_order_add plus handwrytten_basket_send for several orders paid together. Orders spend account credit or charge a card unless the account is in test mode (handwrytten_test_mode_set). Get card IDs from handwrytten_cards_list and font labels from handwrytten_fonts_list.

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

Inputs:

- `card_id` (`integer`, required): ID of the card (stationery design) to use. Get card IDs from handwrytten_cards_list. Example: 3404.
- `font_label` (`string`, required): The colloquial name of the font, such as 'Fancy Jenna' or 'Casual David'. Example: Chill Charity.
- `message` (`string`, required): The handwritten message text. Use \n for new lines. Example: Dear Frank,\nThank you so much for your business.
- `recipient_address1` (`string`, required): The recipient's street address, first line. Example: 1600 Main Street.
- `recipient_city` (`string`, required): The recipient's city. Example: Phoenix.
- `recipient_zip` (`string`, required): The recipient's ZIP or postal code. Example: 85004.
- `sender_address1` (`string`, required): The sender's street address, first line. Example: 9280 South Kyrene Road.
- `sender_city` (`string`, required): The sender's city. Example: Tempe.
- `sender_zip` (`string`, required): The sender's ZIP or postal code. Example: 85284.
- `bundle_id` (`integer`, optional): Bundle to ship with the order. Use GET /bundles/list to fetch the available bundles. Example: 7.
- `client_metadata` (`string`, optional): Your own reference stored with the order and returned in order details and webhooks, such as a CRM contact ID. Example: crm-contact-48213.
- `coupon_code` (`string`, optional): Coupon code to apply to the order price. Example: SPRING10.
- `credit_card_id` (`integer`, optional): The credit card id to charge for the order. Example: 34124.
- `date_send` (`string`, optional): Date to send the card, as YYYY-MM-DD. Leave empty to send as soon as possible. Example: 2026-02-01.
- `delivery_confirmation` (`integer`, optional): Delivery confirmation option for the order: 0 — none, 1 — delivery confirmation, 2 — CASS validation only. Example: 0. One of: `0`, `1`, `2`.
- `denomination_id` (`integer`, optional): Gift card denomination ID to enclose with the card. Get IDs from handwrytten_gift_cards_list. Example: 12.
- `insert_id` (`integer`, optional): ID of a custom insert to enclose with the card. Get IDs from handwrytten_inserts_list. Example: 51.
- `recipient_address2` (`string`, optional): The recipient's street address, second line (suite, apartment). Example: Apt 4.
- `recipient_business_name` (`string`, optional): The recipient's business name. Example: Jones Plumbing.
- `recipient_country` (`string`, optional): The recipient's country name (default United States). Example: United States.
- `recipient_country_id` (`integer`, optional): The recipient's Handwrytten country ID (1 United States, 2 Canada; default 1); see handwrytten_countries_list. Example: 1.
- `recipient_first_name` (`string`, optional): The recipient's first name. Example: Frank.
- `recipient_last_name` (`string`, optional): The recipient's last name. Example: Jones.
- `recipient_state` (`string`, optional): The recipient's state or province code; required for the United States and Canada. Example: AZ.
- `sender_address2` (`string`, optional): The sender's street address, second line (suite, apartment). Example: Suite 134.
- `sender_business_name` (`string`, optional): The sender's business name. Example: Acme Realty.
- `sender_country` (`string`, optional): The sender's country name (default United States). Example: United States.
- `sender_country_id` (`integer`, optional): The sender's Handwrytten country ID (1 United States, 2 Canada; default 1); see handwrytten_countries_list. Example: 1.
- `sender_first_name` (`string`, optional): The sender's first name. Example: Joe.
- `sender_last_name` (`string`, optional): The sender's last name. Example: Smith.
- `sender_state` (`string`, optional): The sender's state or province code; required for the United States and Canada. Example: AZ.
- `stamp_option_id` (`integer`, optional): Stamp option to use. Applies to US orders; ignored for international. Use GET /shipping/stampOptions to fetch the available options. Example: 2.
- `validate_address` (`boolean`, optional): true checks the recipient address before accepting the order. Example: true.
- `webhook_url` (`string`, optional): URL Handwrytten calls when the order status changes. Example: https://example.com/hooks/handwrytten.
- `wishes` (`string`, optional): The closing (sign-off) written right-aligned under the message, such as All the best, Joe. Use \n for new lines. Example: All the best,\nJoe.

Example input: `{"card_id":3404,"font_label":"<font_label>","message":"<message>","recipient_address1":"<recipient_address1>","recipient_city":"<recipient_city>","recipient_zip":"<recipient_zip>","sender_address1":"<sender_address1>","sender_city":"<sender_city>","sender_zip":"<sender_zip>"}`

### `handwrytten_prospecting_order_add`

Add Prospecting Order to Basket · Write

Add a prospecting campaign to the basket: cards to residential or business prospects around an address, with a message, font and return address. Returns the basket order. Call handwrytten_basket_send to pay and submit it. Count prospects first with handwrytten_prospecting_targets_calculate.

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

Inputs:

- `address` (`string`, required): Street address to serve as a central point for prospecting search. Example: 9280 South Kyrene Road.
- `card_id` (`integer`, required): ID of the card (stationery design) to use. Get card IDs from handwrytten_cards_list. Example: 3404.
- `city` (`string`, required): City. For prospecting tools use the format STATE;City, for example AZ;Tempe. Example: Phoenix.
- `country` (`string`, required): Country for prospecting: United States or Canada. Example: United States.
- `font` (`string`, required): Handwriting font ID (slug) for the message, such as hwDavid. Get IDs from handwrytten_fonts_list. Example: hwDavid.
- `message` (`string`, required): The handwritten message text. Use \n for new lines. Example: Dear Frank,\nThank you so much for your business.
- `radius` (`integer`, required): Search radius in miles from the central point. Example: 5.
- `records` (`integer`, required): Number of prospects (cards) to send. Example: 5.
- `return_address_id` (`integer`, required): ID of the sender (return) address. Get IDs from handwrytten_sender_addresses_list. Example: 88123.
- `zip` (`string`, required): ZIP or postal code. Example: 85004.
- `font_size` (`integer`, optional): Font size in points for the handwritten message. Leave empty for the default size. Example: 13.
- `h_age` (`string`, optional): Household age for residential search. Use dash to separate multiple values. Example: 2-3.
- `hinc_d` (`string`, optional): Household income for residential search. Use dash to separate multiple values. Example: 5-6.
- `home_d` (`string`, optional): Home value for residential search. Use dash to separate multiple values. Example: 3-4.
- `insert_id` (`integer`, optional): ID of a custom insert to enclose with the card. Get IDs from handwrytten_inserts_list. Example: 51.
- `kids` (`string`, optional): Children in household for residential search. Use dash to separate multiple values. Example: 1.
- `latitude` (`string`, optional): Latitude to serve as a central point for prospecting search. If not using latitude and longitude, set them to 1. We use them for a secondary search if nothing was found at the address. Example: 1.
- `longitude` (`string`, optional): Longitude to serve as a central point for prospecting search. If not using latitude and longitude, set them to 1. We use them for a secondary search if nothing was found at the address. Example: 1.
- `marital` (`string`, optional): Marital status for residential search. Use dash to separate multiple values. Example: 2.
- `mask` (`boolean`, optional): If no data was found at the address, try searching by geodata. Example: true.
- `must_deliver_by` (`string`, optional): Date the cards must arrive by, in MM/DD/YYYY format. Example: 03/15/2026.
- `own_rent_d` (`string`, optional): Home ownership for residential search. Use dash to separate multiple values. Example: 1.
- `people` (`string`, optional): People in household for residential search. Use dash to separate multiple values. Example: 2.
- `res_len_d` (`string`, optional): Length of residency for residential search. Use dash to separate multiple values. Example: 1-2.
- `search_value` (`string`, optional): The address text used for the prospecting search, as shown in the Handwrytten app. Example: 9280 South Kyrene Road, Tempe, AZ.
- `shipping_address_id` (`integer`, optional): ID of the address to ship the cards to when they are not mailed directly. Get IDs from handwrytten_sender_addresses_list. Example: 88123.
- `shipping_method_id` (`integer`, optional): Shipping method. - 1: Mail Normally - 2: Ship: Address, Seal, Stamp - 3: Ship: Cards Only (no envelope) - 4: Ship: Cards Only (blank envelope unsealed) - 5: Ship: Addressed & Unsealed - 6: Ship: Addressed & Sealed. Example: 1. One of: `1`, `2`, `3`, `4`, `5`, `6`.
- `shipping_rate_id` (`integer`, optional): Shipping rate. - 1: Ground - 2: 2-Day - 3: Overnight - 4: Overnight Priority. Example: 1. One of: `1`, `2`, `3`, `4`.
- `signature_id` (`integer`, optional): ID of a custom signature to add. Get IDs from handwrytten_signatures_list. Example: 512.
- `signature2_id` (`integer`, optional): ID of a second custom signature. Get IDs from handwrytten_signatures_list. Example: 513.
- `wishes` (`string`, optional): The closing (sign-off) written right-aligned under the message, such as All the best, Joe. Use \n for new lines. Example: All the best,\nJoe.
- `worth_d` (`string`, optional): Net worth for residential search. Use dash to separate multiple values. Example: 4-5.

Example input: `{"address":"<address>","card_id":3404,"city":"<city>","country":"<country>","font":"<font>","message":"<message>","radius":5,"records":5,"return_address_id":88123,"zip":"<zip>"}`

### `handwrytten_qr_code_create`

Create QR Code · Write

Create a trackable QR code that points to a URL, for printing on custom cards. Returns the QR code ID. Use handwrytten_qr_code_stats_get for scan counts.

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

Inputs:

- `name` (`string`, required): Name to save the record under. Example: Frank Jones.
- `url` (`string`, required): Destination URL the QR code points to. Example: https://www.example.com/offer.

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

### `handwrytten_recipient_create`

Add Recipient Address · Write

Save a new recipient address to the address book. Returns the new address ID. Get country IDs from handwrytten_countries_list.

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

Inputs:

- `address1` (`string`, required): Street address, first line. Example: 1600 Main Street.
- `city` (`string`, required): City. For prospecting tools use the format STATE;City, for example AZ;Tempe. Example: Phoenix.
- `country_id` (`string`, required): Handwrytten country ID: 1 is the United States, 2 is Canada. Get other IDs from handwrytten_countries_list. Example: 1.
- `first_name` (`string`, required): First name of the person at the address. Example: Frank.
- `zip` (`string`, required): ZIP or postal code. Example: 85004.
- `address2` (`string`, optional): Street address, second line (suite, apartment). Example: Apt 4.
- `birthday` (`string`, optional): Birthday of the recipient as YYYY-MM-DD, for birthday campaigns. Example: 1985-04-12.
- `last_name` (`string`, optional): Last name of the person at the address. Example: Jones.
- `name` (`string`, optional): Name to save the record under. Example: Frank Jones.
- `state` (`string`, optional): State or province code, required for the United States and Canada, for example AZ. Example: AZ.

Example input: `{"address1":"<address1>","city":"<city>","country_id":"<country_id>","first_name":"<first_name>","zip":"<zip>"}`

### `handwrytten_recipient_update`

Update Recipient Address · Write

Update a saved recipient address. Returns the result. Get address IDs from handwrytten_recipients_list.

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

Inputs:

- `address_id` (`string`, required): ID of the saved address to act on. Get recipient IDs from handwrytten_recipients_list and sender IDs from handwrytten_sender_addresses_list. Example: 90211.
- `address1` (`string`, optional): Street address, first line. Example: 1600 Main Street.
- `address2` (`string`, optional): Street address, second line (suite, apartment). Example: Apt 4.
- `birthday` (`string`, optional): Birthday of the recipient as YYYY-MM-DD, for birthday campaigns. Example: 1985-04-12.
- `business_name` (`string`, optional): Business name printed on the address. Example: Jones Plumbing.
- `city` (`string`, optional): City. For prospecting tools use the format STATE;City, for example AZ;Tempe. Example: Phoenix.
- `country_id` (`string`, optional): Handwrytten country ID: 1 is the United States, 2 is Canada. Get other IDs from handwrytten_countries_list. Example: 1.
- `first_name` (`string`, optional): First name of the person at the address. Example: Frank.
- `last_name` (`string`, optional): Last name of the person at the address. Example: Jones.
- `name` (`string`, optional): Name to save the record under. Example: Frank Jones.
- `state` (`string`, optional): State or province code, required for the United States and Canada, for example AZ. Example: AZ.
- `zip` (`string`, optional): ZIP or postal code. Example: 85004.

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

### `handwrytten_sender_address_create`

Add Sender Address · Write

Save a new sender (return) address, optionally as the default. Returns the new address ID. Get country IDs from handwrytten_countries_list.

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

Inputs:

- `address1` (`string`, required): Street address, first line. Example: 1600 Main Street.
- `city` (`string`, required): City. For prospecting tools use the format STATE;City, for example AZ;Tempe. Example: Phoenix.
- `country_id` (`string`, required): Handwrytten country ID: 1 is the United States, 2 is Canada. Get other IDs from handwrytten_countries_list. Example: 1.
- `zip` (`string`, required): ZIP or postal code. Example: 85004.
- `address2` (`string`, optional): Street address, second line (suite, apartment). Example: Apt 4.
- `business_name` (`string`, optional): Business name printed on the address. Example: Jones Plumbing.
- `default` (`boolean`, optional): true makes this the account's default sender address. Example: true.
- `first_name` (`string`, optional): First name of the person at the address. Example: Frank.
- `last_name` (`string`, optional): Last name of the person at the address. Example: Jones.
- `name` (`string`, optional): Name to save the record under. Example: Frank Jones.
- `state` (`string`, optional): State or province code, required for the United States and Canada, for example AZ. Example: AZ.

Example input: `{"address1":"<address1>","city":"<city>","country_id":"<country_id>","zip":"<zip>"}`

### `handwrytten_sender_address_update`

Update Sender Address · Write

Update a saved sender (return) address. Returns the result. Get address IDs from handwrytten_sender_addresses_list.

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

Inputs:

- `address1` (`string`, optional): Street address, first line. Example: 1600 Main Street.
- `address2` (`string`, optional): Street address, second line (suite, apartment). Example: Apt 4.
- `city` (`string`, optional): City. For prospecting tools use the format STATE;City, for example AZ;Tempe. Example: Phoenix.
- `state` (`string`, optional): State or province code, required for the United States and Canada, for example AZ. Example: AZ.
- `zip` (`string`, optional): ZIP or postal code. Example: 85004.

Example input: `{}`

### `handwrytten_test_mode_set`

Set Test Mode · Write

Switch the account into test mode (1) or back to live mode (0). In test mode orders are accepted but not fulfilled and payments are only authorized. Returns the new mode. Use it before trying the order tools.

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

Inputs:

- `test_mode` (`integer`, required): 1 turns test mode on (orders are not fulfilled or charged), 0 returns to live mode. Example: 1. One of: `0`, `1`.

Example input: `{"test_mode":1}`

### `handwrytten_basket_clear`

Clear Basket · Destructive

Remove every order from the basket without sending them. Returns the result. Use it to discard orders added with handwrytten_basket_order_add.

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

Inputs: none.

Example input: `{}`

### `handwrytten_custom_card_delete`

Delete Custom Card · Destructive

Delete a custom card created on the account. Returns the result. Get custom card IDs from handwrytten_cards_list.

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

Inputs:

- `card_id` (`integer`, required): ID of the custom card to delete. Get it from handwrytten_cards_list. Example: 305578.

Example input: `{"card_id":305578}`

### `handwrytten_custom_image_delete`

Delete Custom Image · Destructive

Delete an uploaded logo or cover image. Returns the result. Get image IDs from handwrytten_custom_images_list.

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

Inputs:

- `image_id` (`integer`, required): ID of an uploaded custom image. Get IDs from handwrytten_custom_images_list. Example: 4410.

Example input: `{"image_id":4410}`

### `handwrytten_order_cancel`

Cancel Order · Destructive

Cancel an order that is paid but not yet processed. Returns the result; processed orders cannot be cancelled and return a 400 error. Get order IDs from the order tools.

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

Inputs:

- `order_id` (`integer`, required): ID of the order. Get it from the order or basket tools. Example: 725563.

Example input: `{"order_id":725563}`

### `handwrytten_qr_code_delete`

Delete QR Code · Destructive

Delete a QR code. Returns the result. Get IDs from handwrytten_qr_codes_list.

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

Inputs:

- `qr_code_id` (`string`, required): ID of the QR code to delete. Get it from handwrytten_qr_codes_list. Example: 234.

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

### `handwrytten_recipients_delete`

Delete Recipient Addresses · Destructive

Delete one recipient address (address_id) or several (address_ids) from the address book. Returns the result. Get IDs from handwrytten_recipients_list.

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

Inputs:

- `address_id` (`number`, optional): ID of the saved address to act on. Get recipient IDs from handwrytten_recipients_list and sender IDs from handwrytten_sender_addresses_list. Example: 90211.
- `address_ids` (`array`, optional): IDs of several saved recipient addresses to send the card to, one order each. Use instead of address_id or addresses. Get IDs from handwrytten_recipients_list. Example: [90211, 90212]

Example input: `{}`

### `handwrytten_sender_addresses_delete`

Delete Sender Addresses · Destructive

Delete one sender address (id) or several (address_ids). Returns the result. Get IDs from handwrytten_sender_addresses_list.

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

Inputs:

- `address_id` (`integer`, optional): ID of one sender address to delete. Use address_ids for several. Get IDs from handwrytten_sender_addresses_list. Example: 88123.
- `address_ids` (`array`, optional): IDs of several saved recipient addresses to send the card to, one order each. Use instead of address_id or addresses. Get IDs from handwrytten_recipients_list. Example: [90211, 90212]

Example input: `{}`

## Related

Other Marketing connectors ([all 190](/agentkit/connectors/?category=marketing)):

- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [Mailchimp](/agentkit/connectors/mailchimp/): Scalekit connector, OAuth, 73 tools
- [Twitter / X](/agentkit/connectors/twitteroauth/): Scalekit connector, OAuth, 92 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 |
