Postalytics Troubleshooting & Error Handling
Audience: Admins, Developers, Agentic Workflow Builders, Support & Operation teams, and Solution Architects
Purpose: Explains how to troubleshoot and resolve common Postalytics errors when sending mail from Kizen.
Overview
The table below outlines common issues you may encounter when sending Postalytics mail in Kizen, how they appear in the UI, their likely causes, and the steps to resolve them.
Send Campaign Mail action does not appear
The Send Campaign Mail option is missing from the Perform Action menu or the Agentic Workflow action appears but cannot be performed on the Contact.
Postalytics is not enabled properly
Verify the plugin is enabled, and you are on a Contact Record. If the action is visible but unavailable, contact Support to enable the required setting.
Missing required fields
The send fails and lists one or more missing fields
Required Contact address or name fields are empty
Populate the missing fields on the Contact Record and retry the send
No campaigns available
No campaigns appear in the campaign selection modal
No Triggered Drip campaigns exist or the API key does not have access
Ensure at least one Triggered Drip campaign exists in Postalytics and confirm API key permissions
Agentic Workflow step fails
Agentic Workflow run is marked Status: failed and an email notification is sent
Required data is missing, the campaign endpoint ID is invalid, or an API error occurred
Review the Agentic Workflow run history, correct the missing data or configuration, and rerun the Agentic Workflow
What's Next
Next, review Sending Mail from a Contact Record with Postalytics to understand required data and how to successfully send one-time mail.
You can also review Sending Mail from Agentic Workflows with Postalytics to learn how to include Postalytics in Agentic Workflows and reduce manual errors.
Last updated
Was this helpful?