# Docupost

DocuPost is a print and mail service that enables users to send digital files as physical letters and postcards via the U.S. Postal Service.

- **Category:** documents
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 3
- **Triggers:** 0
- **Slug:** `DOCUPOST`
- **Version:** 20260223_00

## Tools

### Get Balance

**Slug:** `DOCUPOST_GET_BALANCE`

Tool to check the current account balance in DocuPost. Use this before sending letters or postcards to verify sufficient funds are available.

#### 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 Letter

**Slug:** `DOCUPOST_SEND_LETTER`

Send a physical letter via U.S. mail using DocuPost. Requires recipient address (to_name, to_address1, to_city, to_state, to_zip), sender address (from_name, from_address1, from_city, from_state, from_zip), and a PDF document URL. Example: send_letter( to_name='John Doe', to_address1='123 Main St', to_city='Los Angeles', to_state='CA', to_zip='90210', from_name='Sender Corp', from_address1='456 Sender Rd', from_city='Los Angeles', from_state='CA', from_zip='90210', pdf='https://example.com/document.pdf' )

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pdf` | string | Yes | Public URL of the PDF document to mail (max 10MB, 8.5x11 recommended) |
| `test` | boolean | No | Test mode: letter will not actually be mailed. Default is false. |
| `color` | boolean | No | Print in color. Default is false (black and white). |
| `to_zip` | string | Yes | Recipient's ZIP code (5 digits) |
| `to_city` | string | Yes | Recipient's city |
| `to_name` | string | Yes | Recipient's full name (max 40 characters) |
| `from_zip` | string | Yes | Sender's ZIP code (5 digits) |
| `to_state` | string | Yes | Recipient's U.S. state abbreviation (2 letters) |
| `from_city` | string | Yes | Sender's city |
| `from_name` | string | Yes | Sender's full name or organization (max 40 characters) |
| `from_state` | string | Yes | Sender's U.S. state abbreviation (2 letters) |
| `mail_class` | string ("usps_first_class" | "usps_standard" | "usps_priority_mail" | "usps_priority_mail_express") | No | Mail service class. Options: 'usps_first_class' (default), 'usps_standard', 'usps_priority_mail', 'usps_priority_mail_express'. |
| `to_company` | string | No | Recipient's company or attention line (max 40 characters) |
| `description` | string | No | Optional internal note (max 40 characters). Visible in CSV exports and dashboard. |
| `doublesided` | boolean | No | Double-sided printing. Default is true. |
| `to_address1` | string | Yes | Recipient's street address |
| `to_address2` | string | No | Recipient's secondary address line (apt, suite, etc.) |
| `servicelevel` | string ("certified" | "certified_return_receipt") | No | Service level for first class mail. Options: 'certified', 'certified_return_receipt'. Leave blank for standard delivery. |
| `from_address1` | string | Yes | Sender's street address |
| `from_address2` | string | No | Sender's secondary address line (apt, suite, etc.) |
| `return_envelope` | boolean | No | Include a prepaid return envelope. Default is false. |

#### 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 Postcard

**Slug:** `DOCUPOST_SEND_POSTCARD`

Tool to send a postcard via U.S. mail with specified recipient, sender, and front/back images. Use after confirming recipient addresses and design URLs. Example: send_postcard(to_name='John Doe', ..., front_image='https://...', back_image='https://...')

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `size` | string ("4x6" | "6x9") | No | Postcard size. Defaults to '4x6' if not specified. |
| `to_zip` | string | Yes | Recipient's 5-digit ZIP code |
| `to_city` | string | Yes | Recipient's city |
| `to_name` | string | Yes | Recipient's full name (max 40 characters) |
| `from_zip` | string | Yes | Sender's 5-digit ZIP code |
| `to_state` | string | Yes | Recipient's U.S. state (2-letter abbreviation) |
| `from_city` | string | Yes | Sender's city |
| `from_name` | string | Yes | Sender's full name or company name (max 40 characters) |
| `back_image` | string | Yes | Publicly accessible URL for the postcard's back-side image (recommended: 1875x1275 pixels, PNG format) |
| `from_state` | string | Yes | Sender's U.S. state (2-letter abbreviation) |
| `description` | string | No | Internal note for tracking purposes (not printed on postcard) |
| `front_image` | string | Yes | Publicly accessible URL for the postcard's front-side image (recommended: 1875x1275 pixels, PNG format) |
| `to_address1` | string | Yes | Recipient's street address (line 1) |
| `to_address2` | string | No | Recipient's street address (line 2, e.g., apt/suite number) |
| `from_address1` | string | Yes | Sender's street address (line 1) |
| `from_address2` | string | No | Sender's street address (line 2, e.g., apt/suite number) |

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