truncus-email
Send transactional emails (alerts, reports, receipts, notifications) via the Truncus API. Use when a workflow needs to deliver email to a recipient.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/codevanmoose/truncus-emailTruncus Email
Truncus is a transactional email API for delivering alerts, reports, receipts, and notifications. EU-native infrastructure (AWS SES eu-west-1), deterministic delivery with idempotency enforcement and full event tracing.
When to Use
Use this skill when a workflow needs to send email: system alerts, generated reports, order receipts, password resets, onboarding sequences, monitoring notifications, or any programmatic email delivery.
Authentication
Truncus uses Bearer token authentication. The API key is read from the TRUNCUS_API_KEY environment variable.
Header format:
Authorization: Bearer <TRUNCUS_API_KEY>
API keys use the prefix tr_live_ followed by 64 hex characters. If the key is missing, malformed, or revoked, the API returns HTTP 401 with an error code (MISSING_API_KEY, INVALID_API_KEY, or API_KEY_REVOKED).
Send Endpoint
POST https://truncus.co/api/v1/emails/send
Required Headers
| Header | Value | Required |
|---|---|---|
Authorization | Bearer <TRUNCUS_API_KEY> | Yes |
Idempotency-Key | Unique string per send attempt | Yes |
Content-Type | application/json | Yes |
The Idempotency-Key header is mandatory. Requests without it receive HTTP 400 with code MISSING_IDEMPOTENCY_KEY. If a duplicate key is submitted, the API returns the original message without re-sending (status duplicate).
Required Body Fields
| Field | Type | Description |
|---|---|---|
to | string | Recipient email address (single address) |
from | string | Sender address (must be a verified domain) |
subject | string | Email subject line (non-empty) |
At least one of html, react, or template_id must be provided for the email body.
| Field | Type | Description |
|---|---|---|
html | string | HTML body (max 256KB) |
react | string | React Email JSX template (max 64KB) |
template_id | string | Server-side template ID |
Optional Body Fields
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-codevanmoose-truncus-email": {
"enabled": true,
"auto_update": true
}
}
}