ceven

Postalytics

Triggers physical direct mail sends based on CRM events, manages suppression lists in real time, and syncs physical mail delivery status back to your digital records.

Try Postalytics in Ceven

Ask Ceven anything
Standard

Why use Ceven?

  1. AI native Postalytics integration

    • Describe the outcome and Ceven picks the right Postalytics 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 Postalytics data, across all 24 of its actions.

  2. Managed auth

    • Built in OAuth with automatic token refresh and rotation.
    • One place to manage, scope, and revoke Postalytics 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 Postalytics, when, and on whose behalf.
    • The agent pauses and asks when Postalytics is unclear instead of plowing ahead.

  4. Enterprise grade security

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

Supported tools

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

Add contact
Use this when you need to add a new person to a specific mailing list or update details for an existing contact.
Create campaign
Start a new direct mail send using a pre proofed template and specific sender details.
Create template
Upload HTML markup or image URLs to build a new postcard or letter design for future campaigns.
Create suppression list
Set up a new empty list used to exclude specific contacts from receiving physical mail.
Add suppression contact
Place a contact on a suppression list to ensure they are blocked from all future mailings on that list.
Create webhook
Establish an endpoint to receive real time notifications when mail is sent or delivered.
Get contact lists
Pull all available contact lists including their IDs, current item counts, and creation dates.
Get list contacts
Retrieve all contacts from a specific list with support for pagination and offsets.
Get drip campaigns
List all active triggered drip campaign names and their corresponding endpoint IDs.
Get flows
Pull a list of all available automation flows configured for the account.
Get account details
Retrieve basic account information such as the registered address and contact details.
Delete campaign
Permanently remove a campaign from the system that is no longer required.
Add Account
Tool 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, whi
Create New Campaign
Tool 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.
Create Suppression List Contact
Tool 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.
Delete Account
Tool 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.
Delete Suppression List
Tool to delete a specified suppression list. Use when you need to remove a suppression list that is no longer needed.
Delete Suppression List Contact
Tool to delete a specific contact from a suppression list. Use when you need to remove a contact from a suppression list in Postalytics.
Get All Contact Lists
Tool 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.
Get All Contacts on a List
Tool 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.
Get All Drip Campaigns
Tool 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.
Get All Flows
Tool to retrieve all flows for the requester's account. Use when you need to list or browse available flows.
Get All Webhooks
Tool to retrieve all webhooks configured for the authenticated account. Use when you need to view webhook configurations for campaigns.
Get Integrations
Tool to retrieve all Connect integrations configured for the authenticated user's account. Use when you need to view CRM or data source integrations.
Get My Account
Tool 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.
Get Suppression List
Tool 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.
Get Suppression List Contact
Tool 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.
Get Suppression List Contacts
Tool to get all contacts on a specified suppression list. Use when you need to retrieve contacts that are suppressed for a particular list.
Get Suppression Lists
Tool 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.
Update Account
Tool 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.

30 actions · scroll to see them all

Frequently asked questions

Ceven interacts with Postalytics templates via the API to ensure your branding remains consistent. While you can use Ceven to create a template by providing the raw HTML or image URLs, the best practice is to design and proof your templates within the Postalytics dashboard first. Once a template is proofed and approved, Ceven uses the template ID to trigger sends. This prevents the agent from accidentally sending a design that has not been visually verified by a human. The agent can then dynamically inject customer data into the allowed variable fields of that approved template for every individual mail piece sent.
This depends on the processing stage within Postalytics. Once a campaign is submitted and the files are sent to the print facility, the mail piece cannot be stopped or recalled because it is a physical object. However, if the campaign is still in a pending state or if you are using a drip sequence, Ceven can add the contact to a suppression list immediately. If the contact is on a suppression list before the print file is generated, Postalytics will skip that record. We recommend implementing a short delay in your workflow to allow for last second suppression updates.
Ceven uses the Postalytics webhook tool to listen for event notifications. When Postalytics updates the status of a mail piece to sent or delivered, it pushes a notification to the configured webhook endpoint. Ceven captures this event and can then trigger a downstream action, such as updating a field in Salesforce or sending a Slack notification to an account executive. This creates a closed loop system where physical mail behaves like a digital ad, providing a clear audit trail of exactly when a customer received their physical package.
The Postalytics API handles contact additions by checking for existing records based on the provided identifiers. When Ceven calls the add contact tool, it will either create a new record or update the existing one if the contact is already present on that specific list. This ensures your mailing lists stay clean and you do not waste budget sending multiple identical postcards to the same address. The agent can also be configured to check for the existence of a contact using a search flow before attempting the add action.
Yes, users should be aware that Postalytics implements rate limits on their API endpoints to ensure system stability. If a Ceven workflow attempts to sync thousands of contacts in a single burst, you may encounter 429 Too Many Requests errors. To handle this, Ceven implements an automatic retry logic with exponential backoff. For extremely large lists, we recommend using the pagination parameters provided in the get contacts tool to process records in smaller batches of one hundred. This ensures the synchronization completes without hitting the API ceiling or timing out.
Yes, Ceven can use the add account and update account tools to manage a hierarchy of sub accounts. This is particularly useful for agencies that manage direct mail for multiple clients. The agent can switch context between different sub account IDs to manage lists and campaigns for different brands without needing separate API keys for every single client. You can build a master workflow that distributes a single lead list across multiple sub accounts based on the geographic region of the lead, allowing for localized sender addresses on every postcard.
Suppression lists act as a global filter for any campaign or drip sequence they are associated with. When Ceven adds a contact to a suppression list, that contact is effectively blacklisted from receiving any mail from that list. In a drip sequence, the system checks the suppression status right before the mail piece is sent to the printer. If the agent detects a churn event in your billing system, it can instantly trigger the add suppression contact action, ensuring the customer does not receive a promotional postcard after they have already canceled their service.
While the API allows for template creation via HTML, we strongly advise against generating a brand new template for every single recipient. Doing so would create thousands of unused templates in your Postalytics account and would likely trigger a review process that slows down your sends. Instead, use Ceven to send data to a single template with dynamic variables. The agent handles the mapping of customer names, addresses, and custom offer codes into those variables, allowing the print engine to generate a personalized piece of mail while using one single approved design.

Alternatives to Postalytics

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

Lob logoLobPostGrid logoPostGridPebblePost logoPebblePost

Try Ceven on your stack

Plug Ceven on top of the tools you already run. Connect Postalytics 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