MailChannels Email API Integration for Openclaw

A robust integration for sending emails and processing real-time delivery webhooks via MailChannels.

ttulttul
v1.0.0
Jan 30, 2026
1
3k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install mailchannels

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install mailchannels using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is MailChannels Email API Integration?

The MailChannels Email API skill empowers AI agents to handle transactional email communication and delivery tracking. It integrates directly with MailChannels to provide reliable outbound messaging, utilizing both synchronous and asynchronous sending methods while ensuring secure delivery via DNS domain lockdown and signed webhook verification.

This skill is essential for developers using Openclaw Skills who need a secure, scalable way to manage mail flow and monitor message lifecycles through automated delivery event ingestion. By bridging the gap between raw API calls and agentic workflows, it allows for sophisticated email automation and state management.

MailChannels Email API Integration Use Cases

  • Sending transactional emails directly from AI agents via Openclaw Skills.
  • Monitoring email delivery states such as processed, delivered, or hard-bounced.
  • Automating responses and workflow triggers based on real-time delivery events.
  • Securing sender domains using DNS TXT record lockdown to prevent spoofing.
  • Implementing secure webhook ingestion with RFC 9421 signature verification.

How MailChannels Email API Integration Works

  1. Configure environment variables including the MailChannels API Key and Account ID.
  2. Establish domain authority by creating a DNS TXT record for your sender domain.
  3. Initiate email requests through the /send or /send-async endpoints within the skill workflow.
  4. Register a public webhook endpoint to receive asynchronous delivery events from MailChannels.
  5. Verify incoming webhook signatures using Ed25519 and RFC 9421 standards to ensure authenticity.
  6. Correlate delivery events with internal message IDs using request_id or smtp_id for state updates.

MailChannels Email API Integration Setup

Set the required environment variables in your local environment:

export MAILCHANNELS_API_KEY="your_api_key_here"
export MAILCHANNELS_ACCOUNT_ID="your_account_handle"

Configure your DNS provider with the following TXT record for domain lockdown:

  • Host: _mailchannels.<your-domain>
  • Value: v=mc1; auid=<YOUR_ACCOUNT_ID>

To enable webhook ingestion, update your Openclaw Skills configuration in ~/.clawdbot/moltbot.json to map incoming hooks to the appropriate agent actions.

MailChannels Email API Integration Data Schema & Taxonomy

The skill manages email data and delivery events according to the following structure:

Field Description
personalizations Array containing recipient details and metadata
request_id MailChannels correlation ID used for tracking requests
event The status of the email (e.g., delivered, processed, soft-bounced)
customer_handle The account ID associated with the email activity
signature Header containing the cryptographic signature for webhook security

MailChannels Email API Integration Advanced Features

  • Support for asynchronous sending using the /send-async endpoint for low-latency operations.
  • Cryptographic signature verification using Ed25519 to prevent webhook tampering.
  • Integration with Moltbot hooks for automated routing of delivery events to specific AI agents.
  • Domain-wide lockdown via DNS to ensure only authorized traffic is sent through Openclaw Skills.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*