ceven

Mailtrap

Automates transactional email testing and delivery workflows by syncing contact lists, managing email templates, and monitoring delivery metrics in real time.

Try Mailtrap in Ceven

Ask Ceven anything
Standard

Why use Ceven?

  1. AI native Mailtrap integration

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

  2. Managed auth

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

  4. Enterprise grade security

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

Supported tools

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

Create contact
Use this when you need to add a new recipient with an email address and custom attributes to a Mailtrap account.
Create contact list
Use this to group contacts into segments for targeted transactional campaigns or specialized testing cohorts.
Create email template
Use this to build a reusable HTML or text email layout with a subject line and category for future sends.
Create sending domain
Use this to register a new domain for production email sending before configuring DNS records.
Get sending stats
Pull delivery, bounce, open, and click rates for a specific date range to monitor email health.
Get message body
Pull the full HTML content of a specific message from a sandbox inbox to verify layout and links.
List messages in inbox
Pull a list of recent emails received in a specific sandbox inbox, including search filters for subject or sender.
Import contacts
Use this to upload a large batch of contacts asynchronously via a job ID for bulk processing.
Clean inbox
Use this to wipe all messages from a specific sandbox inbox while keeping the inbox settings intact.
List email templates
Pull all available email templates to find a specific ID or verify the current set of active layouts.
Get billing usage
Pull current cycle consumption for both the Email Sandbox and Email Sending services to avoid limits.
Delete contact
Use this to permanently remove a contact by their UUID or email address from the system.
Create Contact Event
Tool to create a contact event in Mailtrap. Use when you need to track custom events associated with a contact for segmentation or automation triggers.
Create Contact Export
Tool to create a contact export job for a Mailtrap account. Use when you need to export contacts with filters. The export is processed asynchronously - the response includes a job ID and status. Check the status field; when it becomes 'fini
Create Contact Field
Tool to create a custom contact field in Mailtrap. Use when you need to add new contact attributes for personalization and segmentation in email campaigns.
Delete Contact Field
Tool to delete a contact field by its ID. Use when you need to remove a custom contact field from an account.
Delete Contact List
Tool to delete a contact list by its ID. Use when you need to remove a contact list from an account.
Delete Email Template
Tool to delete an email template from a Mailtrap account. Use when you need to remove an existing email template.
Delete Project
Tool to delete a project from Mailtrap. Use when you need to permanently remove a project and its associated resources. Returns the ID of the deleted project.
Delete Sending Domain
Tool to delete a sending domain from a Mailtrap account. Use when you need to remove a domain permanently.
Get Contact
Tool to retrieve a contact by UUID or email address from Mailtrap. Use when you need to fetch details of a specific contact including their subscription status, lists, and custom fields.
Get Contact Export
Tool to retrieve the status of a contact export. Use when you need to check the progress of an export or download the exported contacts file.
Get Contact Field
Tool to retrieve contact field details by field ID. Use when you need to get information about a specific custom field in your contacts.
Get Contact Import Status
Tool to retrieve the status of a contact import operation. Use when you need to check the progress or completion status of a contact import. Use after initiating a contact import to monitor its status and retrieve statistics once finished.
Get Contact List
Tool to retrieve a specific contact list by its ID. Use when you need to fetch details about a contact list in a Mailtrap account.
Get Email Template
Tool to retrieve details of a specific email template by ID. Use when you need to fetch template content, metadata, or configuration for an existing email template.
Get Inbox Attributes
Tool to retrieve inbox attributes from Mailtrap. Use when you need to get details about a specific inbox including its configuration, statistics, and permissions.
Get Message HTML Body
Tool to retrieve the HTML body of a message from Mailtrap. Use when you need to get the formatted HTML content of a specific email message.
Get Permission Resources
Tool to retrieve all resources in account for permission management. Use when you need to see the hierarchical structure of projects, inboxes, and other resources with their access levels for the current authentication token.
Get Project by ID
Tool to retrieve project details from Mailtrap by project ID. Use when you need to get information about a specific project including its inboxes, permissions, and share links.

30 actions · scroll to see them all

Frequently asked questions

Ceven connects to your Mailtrap sandbox inboxes using the API to poll for new messages. When a message arrives, the agent can read the HTML body, check for specific keywords, and verify that the email was sent to the correct recipient. This allows you to build a workflow where a test script triggers an email and Ceven confirms the email actually arrived in the sandbox with the correct content. If the email does not arrive within a set timeframe or contains a broken link, Ceven can trigger a failure notification in Slack or create a Jira ticket automatically.
Yes. Ceven can create new sending domains and retrieve the current DNS verification status for existing ones. While Ceven cannot log into your DNS provider to add the records for you, it can monitor the status in Mailtrap and alert you the moment the domain is verified and ready for use. This is useful for teams managing dozens of white label domains who need a central dashboard to see which domains are active and which are still pending verification from the domain registrar.
Ceven can act as the bridge between your primary database and Mailtrap. You can set up a workflow that triggers whenever a user record is updated in your CRM, which then calls the Create Contact or Import Contacts action in Mailtrap. This ensures your segmentation lists are always current. The agent handles the mapping of custom fields from your database to the custom contact fields in Mailtrap, allowing for highly personalized transactional emails that use the most recent customer data without manual exports.
Yes. Ceven uses the asynchronous import tool provided by Mailtrap. When you trigger a bulk import, Ceven initiates the job and receives a job ID. Because large imports take time to process, the agent periodically checks the import status using the Get Contact Import Status tool. Once the job is marked as complete, Ceven can then verify the number of successfully imported contacts and notify you if any records failed due to formatting errors or duplicate email addresses.
Mailtrap enforces rate limits based on your plan tier. When Ceven encounters a rate limit error, the agent implements an exponential backoff strategy to retry the request. However, if you are on a free plan with very tight limits, you may see a delay in workflow execution during high volume periods. We recommend monitoring your billing usage through the Ceven dashboard to see if your current Mailtrap tier is sufficient for the volume of API calls your workflows are generating.
Ceven can pull comprehensive stats including delivery, bounce, open, and click rates. You can build a weekly report workflow where the agent fetches stats by category or domain, aggregates the data, and summarizes the performance trends. For example, if the bounce rate for password reset emails increases by ten percent over a weekend, Ceven can flag this as a potential deliverability issue and alert your engineering team to check if your IP has been blacklisted.
Ceven interacts with the current version of a template via the Mailtrap API. You can use the Create Email Template action to push new HTML layouts directly from a design tool or a markdown file into Mailtrap. Because Ceven can list and retrieve templates by ID, you can build a staging workflow where a template is created in a test project, verified by a human, and then pushed to the production project by the agent once approved.
Yes. You can schedule a workflow in Ceven to call the Clean Inbox action at specific intervals, such as every night at midnight. This is particularly useful for CI CD pipelines where sandbox inboxes can quickly become cluttered with thousands of test emails. By automating the cleanup, your team ensures that every new test run starts with a fresh inbox, making it much easier to isolate and debug specific email delivery issues during the development cycle.

Alternatives to Mailtrap

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

SendGrid logoSendGridPostmark logoPostmarkMailgun logoMailgun

Try Ceven on your stack

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