---
canonical_url: "https://docs.composio.dev/toolkits/handwrite"
markdown_url: "https://docs.composio.dev/toolkits/handwrite.md"
product: "platform"
version: null
last_updated: null
---

# Handwrite.io

Handwrite.io creates and tracks physical handwritten card orders using selectable handwriting and stationery styles.

- **Category:** customer appreciation
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 4
- **Triggers:** 0
- **Slug:** `HANDWRITE`
- **Version:** 00000000_00

## Tools

### Get Order

**Slug:** `HANDWRITE_GET_ORDER`

Get a Handwrite order by ID, including its current status, test or live environment, addresses, and proof images when available.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `order_id` | string | Yes | Order _id returned by HANDWRITE_SEND_CARDS or obtained from the Handwrite web app. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Handwriting Styles

**Slug:** `HANDWRITE_LIST_HANDWRITING_STYLES`

List the handwriting styles available to the connected Handwrite account, including the style ID required when sending cards and a preview URL.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Stationery

**Slug:** `HANDWRITE_LIST_STATIONERY`

List public stationery and custom stationery available to the connected Handwrite account, including the card ID required when sending cards and a preview URL.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Handwritten Cards

**Slug:** `HANDWRITE_SEND_CARDS`

Create handwritten-card orders for one or more recipients. With a test API key, this creates persistent non-production records and sends no physical cards; with a live API key, it creates billable physical cards for every recipient. Do not call with a live key unless the user intends and authorizes billable physical mailing. The current API has no cancel or delete endpoint.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `send_requests` | array | Yes | Card requests to create. Use one item for a single message/design or multiple items when messages, handwriting styles, or cards differ. Every recipient creates a persistent order; a live API key creates a billable physical card that cannot be cancelled through the current API. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |