> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

![DocuPost logo](https://mintcdn.com/composio-preview/VNLruGH5mLZqXdPH/images/toolkits/docupost.svg?fit=max\&auto=format\&n=VNLruGH5mLZqXdPH\&q=85\&s=bcd1171a21bae3a9226228564ba4d7ce)

* **Category:** documents
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 3
* **Triggers:** 0
* **Slug:** `DOCUPOST`
* **Version:** 20261101\_00

## Tools

> [accordion] Get Account Balance
>
> **Slug:** `DOCUPOST_GET_BALANCE`
>
> Return the connected DocuPost account's numeric balance. This read does not reveal currency, plan, tier, or sandbox status.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send Letter
>
> **Slug:** `DOCUPOST_SEND_LETTER`
>
> Submit one PDF letter for paid printing and US postal delivery using a PDF URL and sender and recipient addresses. This non-idempotent operation can deduct funds and create real mail; avoid automatically retrying ambiguous results, as acceptance does not prove printing or delivery and later errors may appear on the mailing detail page.
>
> #### Input Parameters
>
> **color** `boolean`
>
> Print in color when true; black and white when false.
>
> **sender** `object` *required*
>
> U.S. return address printed for the sender.
>
> **pdf\_url** `string` *required*
>
> Public URL of a PDF up to 10 MB; 8.5x11 pages are recommended.
>
> **recipient** `object` *required*
>
> U.S. postal recipient printed on the envelope.
>
> **mail\_class** `string ("usps_first_class" | "usps_standard" | "usps_priority_mail" | "usps_priority_mail_express")`
>
> USPS mail class used for the letter.
>
> **double\_sided** `boolean`
>
> Print on both sides of each sheet when true.
>
> **service\_level** `string ("certified" | "certified_return_receipt")`
>
> Optional certified-mail service; valid only with usps\_first\_class.
>
> **internal\_description** `string`
>
> Optional internal note shown in DocuPost's dashboard and CSV exports, at most 40 characters.
>
> **include\_return\_envelope** `boolean`
>
> Include a prepaid return envelope. This is the single agent-facing form of DocuPost's duplicate return-envelope parameter names.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send Postcard
>
> **Slug:** `DOCUPOST_SEND_POSTCARD`
>
> Submit one postcard for paid printing and U.S. postal delivery. This is a non-idempotent physical-mail operation: one call can deduct funds and create real mail, so confirm both artworks and all addresses before calling and never automatically retry an ambiguous result. HTTP acceptance is asynchronous and does not prove later printing or delivery; invalid artwork dimensions can fail after acceptance.
>
> #### Input Parameters
>
> **size** `string ("4x6" | "6x9")`
>
> Printed postcard size in inches.
>
> **sender** `object` *required*
>
> U.S. return address printed for the sender.
>
> **recipient** `object` *required*
>
> U.S. postal recipient printed on the postcard.
>
> **back\_image\_url** `string` *required*
>
> Public URL for the postcard back artwork; 1875x1275 pixels and PNG are recommended.
>
> **front\_image\_url** `string` *required*
>
> Public URL for the postcard front artwork; 1875x1275 pixels and PNG are recommended.
>
> **internal\_description** `string`
>
> Optional internal note shown in DocuPost's dashboard and CSV exports; DocuPost publishes no postcard-specific length limit.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
