Direct Mail Automation software in the cloud with deep integration to CRM and workflows, making direct mail look, act and feel like a digital marketing channel
Direct Mail Automation software in the cloud with deep integration to CRM and workflows, making direct mail look, act and feel like a digital marketing channel On Nagent, Postalytics is exposed as a fully-configurable marketing automation integration that any agent can call — 24 actions, and API key authentication. No code is required to wire Postalytics into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Postalytics to automate the kinds of tasks marketing automation teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Postalytics into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Postalytics, with input parameters and output schema. Drop these into any step of an agent built in Helix.
POSTALYTICS_ADD_ACCOUNTTool to create a new sub-account in the Postalytics system. Use when you need to create a new account with a unique ID associated with the requester's user ID as parent. The response includes the API key and user ID for the new account, which should be stored for future API calls.
Input parameters
The phone number associated with the account
The company name associated with the account
The password associated with the account. Must follow password guidelines - minimum 8 characters including 1 uppercase letter, 1 lowercase letter, 1 number, and 1 special character
The username associated with the account - must be unique
The last name of the account holder
The first name of the account holder
The zip code associated with the account's address
The city associated with the account's address
The state associated with the account's address
The email address associated with the account
The street address associated with the account
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
POSTALYTICS_ADD_CONTACTTool to add a contact to a specified contact list with their information. Use when you need to create a new contact or update an existing one on a contact list.
Input parameters
Phone number of the contact.
Company name of the contact.
Website URL of the contact.
Last name of the contact.
The unique id of the contact. Required for updating but not required for inserting.
First name of the contact.
Occupation of the contact.
Zip/postal code for the contact address.
Custom variable field 1 for additional data.
Custom variable field 2 for additional data.
Custom variable field 3 for additional data.
Custom variable field 4 for additional data.
Custom variable field 5 for additional data.
Custom variable field 6 for additional data.
Custom variable field 7 for additional data.
Custom variable field 8 for additional data.
Custom variable field 9 for additional data.
City for the contact address.
The date and time when the contact was created (ISO 8601 format).
Mobile phone number of the contact.
Custom variable field 10 for additional data.
Custom variable field 11 for additional data.
Custom variable field 12 for additional data.
Custom variable field 13 for additional data.
Custom variable field 14 for additional data.
Custom variable field 15 for additional data.
Custom variable field 16 for additional data.
Custom variable field 17 for additional data.
Custom variable field 18 for additional data.
Custom variable field 19 for additional data.
Custom variable field 20 for additional data.
Custom variable field 21 for additional data.
Custom variable field 22 for additional data.
Custom variable field 23 for additional data.
Custom variable field 24 for additional data.
Custom variable field 25 for additional data.
Custom variable field 26 for additional data.
Custom variable field 27 for additional data.
Custom variable field 28 for additional data.
Custom variable field 29 for additional data.
Custom variable field 30 for additional data.
Custom variable field 31 for additional data.
Custom variable field 32 for additional data.
Custom variable field 33 for additional data.
Custom variable field 34 for additional data.
Custom variable field 35 for additional data.
State for the contact address.
Email address of the contact.
Street address for the contact.
Second line of street address for the contact.
The id of the contact list to add this contact to.
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
POSTALYTICS_CREATE_NEW_CAMPAIGNTool to create a new direct mail campaign in Postalytics. Use when you need to start a new campaign with specified sender details and template. Important: A template must be created and proofed before creating the campaign.
Input parameters
The sender's postal code.
The sender's city.
The name of the campaign sender.
Postage type for the campaign. 0 for first class, 1 for standard mail.
The sender's state abbreviation (e.g., NY, CA).
Identifies media type. Valid values are 21-34, including postcards, letters, and bifolds in first class or standard mail.
The sender's country code. Defaults to 'US' if not specified.
The name of the direct mail campaign.
The sender's primary street address.
The sender's secondary address line (e.g., apartment, suite number).
The ID of the template to use for the front of this campaign. Template must be created and proofed before campaign creation.
Custom envelope ID for letter campaigns. Optional parameter only applicable to letter-type campaigns.
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
POSTALYTICS_CREATE_SUPPRESSION_LISTTool to create a new suppression list that can be used in campaigns to suppress contacts from being sent mail. Use when you need to create an empty suppression list. Note that contacts must be added separately using the SuppressionListContact API after the list is created.
Input parameters
The name of the suppression list.
The country associated with the suppression list (e.g., 'US', 'CA').
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
POSTALYTICS_CREATE_SUPPRESSION_LIST_CONTACTTool to create a new suppression contact on a specified suppression list. Use when you need to add a contact to a suppression list to prevent them from receiving mailings.
Input parameters
Zip/postal code.
City.
Email address of the contact.
Phone number.
State.
Mobile phone number.
Primary address line.
Company name.
Country.
Website URL.
The id of the suppression list to add the contact to.
Secondary address line.
Last name of the contact.
First name of the contact.
Custom variable field 1.
Custom variable field 2.
Custom variable field 3.
Custom variable field 4.
Custom variable field 5.
Custom variable field 6.
Custom variable field 7.
Custom variable field 8.
Custom variable field 9.
Occupation.
Custom variable field 10.
Custom variable field 11.
Custom variable field 12.
Custom variable field 13.
Custom variable field 14.
Custom variable field 15.
Custom variable field 16.
Custom variable field 17.
Custom variable field 18.
Custom variable field 19.
Custom variable field 20.
Custom variable field 21.
Custom variable field 22.
Custom variable field 23.
Custom variable field 24.
Custom variable field 25.
Custom variable field 26.
Custom variable field 27.
Custom variable field 28.
Custom variable field 29.
Custom variable field 30.
Custom variable field 31.
Custom variable field 32.
Custom variable field 33.
Custom variable field 34.
Custom variable field 35.
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
POSTALYTICS_CREATE_TEMPLATETool to create a new template with full HTML for postcard or letter. Use when you need to create a template by providing complete HTML markup or image URLs for front/back. The template can be used for various mail types including postcards, letters, and bifolds.
Input parameters
URL for full-sized back image or letter content. Used when is_full_html is false.
Complete HTML markup for the template following Postalytics formatting standards.
Template identifier name (e.g., 'The Architect', 'Welcome Postcard').
Template dimensions: '0'=letter, '1'=4x6 postcard, '2'=6x9 postcard, '3'=6x11 postcard, '6'=12x9 bifold, '7'=6x18 bifold.
Page count for letter templates. Default: 0.
URL for full-sized front image or letter content. Used when is_full_html is false.
Indicates proofing status; bypasses web app safeguards when true. Default: false.
CSS font family designation (e.g., 'sans-serif', 'Arial').
Determines whether HTML is sent as complete markup (true) or as separate front/back images (false). Default: true.
Specifies double-sided letter configuration. Default: 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
POSTALYTICS_CREATE_WEBHOOKTool to create a new webhook to receive campaign event notifications from Postalytics. Use when you need to set up a webhook endpoint that will be notified about campaign events like sent, delivered, opened, or clicked.
Input parameters
The destination URL that will receive webhook event notifications.
Human-readable name for the webhook to help identify it.
List of campaign event types to subscribe to. Common events include 'sent', 'delivered', 'opened', 'clicked'.
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
POSTALYTICS_DELETE_ACCOUNTTool to delete a Postalytics account and all associated campaigns, templates, and lists. Use when you need to permanently remove a sub account or sub user account. Cannot delete parent accounts.
Input parameters
The unique identifier of the account to delete. Only sub accounts and sub user accounts can be deleted. Cannot delete parent accounts.
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
POSTALYTICS_DELETE_CAMPAIGNTool to delete a campaign from the system. Use when you need to remove a campaign that is no longer needed.
Input parameters
Integer contains the Id of the campaign to delete.
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
POSTALYTICS_DELETE_SUPPRESSION_LISTTool to delete a specified suppression list. Use when you need to remove a suppression list that is no longer needed.
Input parameters
The ID of the suppression list to delete
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
POSTALYTICS_DELETE_SUPPRESSION_LIST_CONTACTTool to delete a specific contact from a suppression list. Use when you need to remove a contact from a suppression list in Postalytics.
Input parameters
The ID of the suppression list
The ID of the contact to be deleted from the list
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
POSTALYTICS_GET_ALL_CONTACT_LISTSTool to retrieve all contact lists for an account. Use when you need to get a complete list of contact lists including their IDs, names, item counts, and creation dates.
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
POSTALYTICS_GET_ALL_CONTACTS_ON_A_LISTTool to retrieve all contacts from a specified contact list with pagination support. Use when you need to get contacts from a list, with optional pagination using start offset and limit parameters.
Input parameters
Maximum number of contacts to return per page. Controls pagination page size.
Pagination offset for retrieving contacts. Use 0 for the first page.
The unique identifier of the contact list to retrieve contacts from.
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
POSTALYTICS_GET_ALL_DRIP_CAMPAIGNSTool to retrieve all triggered drip campaign names and endpoint IDs in the account. Use when you need to list all available drip campaigns for the authenticated user.
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
POSTALYTICS_GET_ALL_FLOWSTool to retrieve all flows for the requester's account. Use when you need to list or browse available flows.
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
POSTALYTICS_GET_ALL_WEBHOOKSTool to retrieve all webhooks configured for the authenticated account. Use when you need to view webhook configurations for campaigns.
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
POSTALYTICS_GET_INTEGRATIONSTool to retrieve all Connect integrations configured for the authenticated user's account. Use when you need to view CRM or data source integrations.
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
POSTALYTICS_GET_MY_ACCOUNTTool to retrieve basic account information for the authenticated user. Use when you need to get account details such as contact information, address, or API key.
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
POSTALYTICS_GET_SUPPRESSION_LISTTool to get the details of a suppression list based on the id supplied. Use when you need to retrieve information about a specific suppression list.
Input parameters
The id of the suppression list to retrieve.
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
POSTALYTICS_GET_SUPPRESSION_LIST_CONTACTTool to retrieve a specific contact from a suppression list. Use when you need to get details about a contact on a specific suppression list by their list ID and contact ID.
Input parameters
Offset for pagination
The ID of the suppression list
The ID of the suppression list contact
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
POSTALYTICS_GET_SUPPRESSION_LIST_CONTACTSTool to get all contacts on a specified suppression list. Use when you need to retrieve contacts that are suppressed for a particular list.
Input parameters
The listId of the suppression list to get contacts for.
Offset count for paging through results.
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
POSTALYTICS_GET_SUPPRESSION_LISTSTool to retrieve all suppression lists for the authenticated user. Use when you need to view or manage suppression lists. Returns all lists or a specific list when ID is provided.
Input parameters
The identifier of a specific suppression list to retrieve. If not provided, all suppression lists will be returned.
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
POSTALYTICS_UPDATE_ACCOUNTTool to update an existing account in the Postalytics system. Use when you need to modify account information such as contact details, address, or credentials for an existing account.
Input parameters
The phone number associated with the account
The company name associated with the account
The password associated with the account. Must follow password guidelines - minimum 8 characters including 1 uppercase letter, 1 lowercase letter, 1 number, and 1 special character
The username associated with the account - must be unique
The last name of the account holder
The unique identifier of the account to update
The first name of the account holder
The zip code associated with the account's address
The city associated with the account's address
The state associated with the account's address
The email address associated with the account
The street address associated with the account
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
POSTALYTICS_UPDATE_SUPPRESSION_LIST_CONTACTTool to update a suppression contact on the specified suppression list. Use when you need to modify contact information for a specific contact on a suppression list.
Input parameters
Postal/ZIP code
City name
Email address
Phone number
State/Province
Mobile phone number
Street address
Company name
Country
Website URL
The id of the suppression list the contact is on
Additional address line
Last name
First name
Custom variable field 1
Custom variable field 2
Custom variable field 3
Custom variable field 4
Custom variable field 5
Custom variable field 6
Custom variable field 7
Custom variable field 8
Custom variable field 9
Occupation
Custom variable field 10
Custom variable field 11
Custom variable field 12
Custom variable field 13
Custom variable field 14
Custom variable field 15
Custom variable field 16
Custom variable field 17
Custom variable field 18
Custom variable field 19
Custom variable field 20
Custom variable field 21
Custom variable field 22
Custom variable field 23
Custom variable field 24
Custom variable field 25
Custom variable field 26
Custom variable field 27
Custom variable field 28
Custom variable field 29
Custom variable field 30
Custom variable field 31
Custom variable field 32
Custom variable field 33
Custom variable field 34
Custom variable field 35
The id of the contact to be updated
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
No publicly available marketplace agent is found using this tool yet. There are 35 agents privately built on Nagent that already use Postalytics.
Build on Nagent
Connect Postalytics to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Postalytics, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Postalytics is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Postalytics is connected, you configure its 24 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Postalytics steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Postalytics event fires, the agent kicks off automatically.
Every Postalytics action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Postalytics ships with 24 pre-built marketing automation actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Postalytics together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Postalytics-based workflows tailored to your business.