Skip to content
TakoAPI
Back to skills

mailchannels

by ttulttul

Moltbook
1.8kDownloads reported by clawskills.sh
1Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Send email via MailChannels Email API and ingest signed.

Description

What This Skill Does

Sends transactional email through the MailChannels API and tracks delivery outcomes via signed webhooks. Supports synchronous and async send modes with correlation ID tracking across processed, delivered, bounce, and drop events. Webhook signatures are verified using ed25519 per RFC 9421.

Combines email sending and delivery-event ingestion in one flow, including ed25519 webhook signature verification that most simple email wrappers omit.

When to Use It

  • Sending welcome emails after user registration
  • Tracking bounce and drop events for outbound campaigns
  • Routing delivery failure notifications to an internal dashboard
  • Verifying signed webhook payloads before processing delivery state updates
  • Enrolling a public endpoint to receive MailChannels delivery events

Example Workflow

INPUT

User asks: Send a welcome email to new@example.com and confirm when it is delivered

AGENT
  1. 1

    Constructs POST /send payload with personalizations, from, subject, and content fields

  2. 2

    Sends request to MailChannels API with X-Api-Key header and persists the returned request_id

  3. 3

    Registers webhook endpoint via POST /webhook?endpoint=<url>

  4. 4

    Verifies incoming webhook signature by fetching the public key and validating ed25519 against the RFC 9421 signature base

  5. 5

    Updates delivery state to delivered when the matching event arrives with the stored request_id

OUTPUT

Email sent and delivery confirmed via webhook event with status 'delivered'

Requirements

  • MAILCHANNELS_API_KEY environment variable
  • MAILCHANNELS_ACCOUNT_ID environment variable
  • MailChannels account

Installation

clawhub install ttulttul/mailchannels

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links