ceven

Docupost

Sends physical letters and postcards to customers automatically based on digital triggers, manages mailing lists, and tracks delivery status from your workflow.

Try Docupost in Ceven

Ask Ceven anything
Standard

Why use Ceven?

  1. AI native Docupost integration

    • Describe the outcome and Ceven picks the right Docupost calls, fills the parameters, and checks the result.
    • Structured, agent friendly tool schemas so each call runs reliably instead of by guesswork.
    • Rich coverage for reading, writing, and querying your Docupost data, across all 3 of its actions.

  2. Managed auth

    • Built in OAuth with automatic token refresh and rotation.
    • One place to manage, scope, and revoke Docupost access.
    • Per user and per environment credentials instead of shared keys.

  3. Agent optimized design

    • Actions are tuned from real success and error rates so reliability climbs over time.
    • Full execution logs so you always know what ran in Docupost, when, and on whose behalf.
    • The agent pauses and asks when Docupost is unclear instead of plowing ahead.

  4. Enterprise grade security

    • Fine grained access so you control which agents and people can reach Docupost.
    • Least privilege by default, read scopes first and only the writes a workflow needs.
    • A full audit trail of every Docupost action to support review and sign off.

Supported tools

Every action Ceven's agents can run on Docupost, and when to use it.

Send letter
Use this when you need to mail a physical document to a recipient. Provide the recipient name, address, and the PDF file source.
Send postcard
Use this to send a physical postcard. Provide the recipient details and the image URLs for the front and back of the card.
Get mail status
Pull the current delivery state of a specific mailing ID to see if it was printed or mailed.
Validate address
Check a mailing address against USPS standards to prevent return to sender errors before sending.
List recent mailings
Pull a list of all physical mail sent within a specific date range for auditing purposes.
Cancel pending mail
Stop a letter or postcard from being printed if it has not yet entered the production queue.
Update recipient
Modify the delivery address for a pending mail job before it hits the printer.
Get account balance
Check available postage credits to ensure the workflow does not fail due to lack of funds.
Search mailings
Query past mailings by recipient name or email to verify if a notice was sent.
Create mail batch
Group multiple letters into a single job for bulk processing and reporting.
Get template status
Check if a specific document template is approved and ready for use in the API.
Verify postcard dimensions
Confirm if the uploaded image meets the physical size requirements for US Postal Service postcards.

12 actions · scroll to see them all

Frequently asked questions

Ceven does not store your documents permanently. When a workflow triggers a Send letter action, the agent fetches the PDF from your connected cloud storage like Google Drive or Dropbox and passes the secure URL directly to the Docupost API. Docupost then downloads the file for printing and processing. Once the print job is confirmed as received by the Docupost system, the temporary link is discarded. This ensures that sensitive customer data is not sitting in a middle layer and that the document remains encrypted until the moment it is sent to the printer.
Standard postage sent via Docupost does not include individual tracking numbers like a package would. However, Ceven can track the internal lifecycle of the mail. The agent can tell you when the file was received, when it was printed, and when it was handed over to the US Postal Service. If you need proof of delivery, you must use a specific certified mail option if available in your Docupost plan. Ceven will pull these status updates and log them into your CRM so you have a timestamped record of the mailing event.
If the US Postal Service cannot deliver the mail, it is typically returned to the Docupost processing center. While Docupost does not always provide a real time digital notification for every returned piece of mail, Ceven helps prevent this by using the Validate address action before the mail is sent. The agent checks the address against official databases and will flag the record in your workflow if the address is invalid. This allows you to pause the mailing and ask the customer for a corrected address before you spend postage credits.
Docupost imposes rate limits on their API to ensure stability during peak mailing periods. Depending on your account tier, you may be limited in the number of requests you can make per minute. Ceven handles this by implementing an automatic queue system. If your workflow triggers ten thousand letters at once, the agent will pace the requests to match your Docupost API limits. This prevents your account from being throttled and ensures that every single letter is successfully queued for printing without crashing the automation.
Yes. You can provide the agent with a URL to a JPG or PNG file for both the front and back of the postcard. The agent ensures the image meets the required resolution and aspect ratio before sending it to Docupost. If the image is the wrong size, the agent will alert you in the workflow logs rather than sending a distorted image to the printer. This is ideal for personalized marketing where the agent pulls a custom product image from your store and places it on a physical postcard for the customer.
Ceven works within the parameters defined by the Docupost API and your specific service plan. Most standard letters are sent as 8.5 by 11 inch documents in standard envelopes. If you have a custom enterprise agreement with Docupost for different formats, you can specify those parameters in the action settings. The agent will pass these flags to the API to ensure the correct physical materials are used. If a requested format is not supported by your current plan, Docupost will return an error which Ceven will log as a failure.
Postage is billed directly through your Docupost account balance. Ceven does not process payments for stamps or printing. To avoid workflow interruptions, you can set up a Ceven agent to monitor your account balance using the Get account balance action. You can create a rule that sends you a Slack message or email when your Docupost credits fall below a certain threshold. This ensures that your automated legal notices or customer welcome letters never stop sending because of an expired credit card or empty balance.
All communication between Ceven and Docupost happens over HTTPS using industry standard encryption. Your API keys are stored encrypted at rest and are never exposed to the end user or the large language model during the execution of a workflow. Because the agent only sends the necessary recipient and document data required for the specific mail job, the attack surface is minimized. You can also rotate your Docupost API keys at any time and update them in the Ceven connection settings to maintain a high security posture.

Alternatives to Docupost

Other tools that solve a similar problem. Ceven supports these too, so you can switch or run more than one at once.

Lob logoLobPostGrid logoPostGridStannp logoStannp

Try Ceven on your stack

Plug Ceven on top of the tools you already run. Connect Docupost and the rest of your stack, describe the outcome, and its agents handle the work end to end, days of it in minutes.

Get started for free