NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Docupost connects to a Nagent workspace with an API key. Once it is connected, agents can call 3 Docupost actions: "Get Balance", "Send Letter" and "Send Postcard". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Docupost, with input parameters and output schema.
DOCUPOST_GET_BALANCETool to check the current account balance in DocuPost. Use this before sending letters or postcards to verify sufficient funds are available.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DOCUPOST_SEND_LETTERSend 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
Public URL of the PDF document to mail (max 10MB, 8.5x11 recommended)
Test mode: letter will not actually be mailed. Default is false.
Print in color. Default is false (black and white).
Recipient's ZIP code (5 digits)
Recipient's city
Recipient's full name (max 40 characters)
Sender's ZIP code (5 digits)
Recipient's U.S. state abbreviation (2 letters)
Sender's city
Sender's full name or organization (max 40 characters)
Sender's U.S. state abbreviation (2 letters)
Mail service class. Options: 'usps_first_class' (default), 'usps_standard', 'usps_priority_mail', 'usps_priority_mail_express'.
Recipient's company or attention line (max 40 characters)
Optional internal note (max 40 characters). Visible in CSV exports and dashboard.
Double-sided printing. Default is true.
Recipient's street address
Recipient's secondary address line (apt, suite, etc.)
Service level for first class mail. Options: 'certified', 'certified_return_receipt'. Leave blank for standard delivery.
Sender's street address
Sender's secondary address line (apt, suite, etc.)
Include a prepaid return envelope. Default is false.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DOCUPOST_SEND_POSTCARDTool 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
Postcard size. Defaults to '4x6' if not specified.
Recipient's 5-digit ZIP code
Recipient's city
Recipient's full name (max 40 characters)
Sender's 5-digit ZIP code
Recipient's U.S. state (2-letter abbreviation)
Sender's city
Sender's full name or company name (max 40 characters)
Publicly accessible URL for the postcard's back-side image (recommended: 1875x1275 pixels, PNG format)
Sender's U.S. state (2-letter abbreviation)
Internal note for tracking purposes (not printed on postcard)
Publicly accessible URL for the postcard's front-side image (recommended: 1875x1275 pixels, PNG format)
Recipient's street address (line 1)
Recipient's street address (line 2, e.g., apt/suite number)
Sender's street address (line 1)
Sender's street address (line 2, e.g., apt/suite number)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 3 Docupost actions on Nagent: "Get Balance", "Send Letter" and "Send Postcard". Get Balance: Check the current account balance in DocuPost. Each action is listed on this page with its input parameters and its output.
Docupost connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
It returns data, error and successful.