mailtarget-email
Send transactional and marketing emails via Mailtarget API. Manage sending domains, templates, API keys, and sub-accounts. Use when the agent needs to send emails, manage email templates, configure sending domains, or handle any email infrastructure task through Mailtarget (mailtarget.co). Supports HTML emails, attachments, click/open tracking, template-based sending with substitution data, CC/BCC, reply-to, and custom headers.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/masasdani/mailtarget-emailMailtarget Email
Send emails and manage email infrastructure via the Mailtarget API.
Setup
Set the MAILTARGET_API_KEY environment variable with your Mailtarget API key.
Get your API key from the Mailtarget dashboard → Settings → API Keys.
Sending Email
Use curl or any HTTP client. All requests go to https://transmission.mailtarget.co/v1 with Authorization: Bearer $MAILTARGET_API_KEY.
Simple send
curl -X POST https://transmission.mailtarget.co/v1/layang/transmissions \
-H "Authorization: Bearer $MAILTARGET_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": [{"email": "[email protected]", "name": "Recipient"}],
"from": {"email": "[email protected]", "name": "Your App"},
"subject": "Hello from Mailtarget",
"bodyHtml": "<h1>Hello!</h1><p>This is a test email.</p>",
"bodyText": "Hello! This is a test email."
}'
A successful response returns {"message": "Transmission received", "transmissionId": "..."}.
Template-based send
Use templateId with substitutionData instead of bodyHtml/bodyText:
{
"to": [{"email": "[email protected]", "name": "User"}],
"from": {"email": "[email protected]", "name": "Your App"},
"subject": "Welcome, {{name}}!",
"templateId": "welcome-template",
"substitutionData": {"name": "User", "company": "Acme"}
}
Tracking options
Control click and open tracking per transmission:
{
"optionsAttributes": {
"clickTracking": true,
"openTracking": true,
"transactional": true
}
}
Set transactional: true for transactional emails (password resets, receipts) to bypass unsubscribe preferences.
Attachments
Include base64-encoded attachments:
{
"attachments": [{
"filename": "report.pdf",
"mimeType": "application/pdf",
"value": "<base64-encoded-content>"
}]
}
Managing Templates
- List:
GET /template?page=1&size=10&search=keyword - Create:
POST /templatewith{"id": "slug", "name": "Display Name", "html": "<html>..."}
Managing Sending Domains
- List:
GET /domain/sending - Create:
POST /domain/sendingwith{"domain": "example.com"} - Verify:
PUT /domain/sending/{id}/verify-txt - Check SPF:
GET /domain/sending/{id}/spf-suggestion
Autonomous Domain Setup (with cloudflare-dns skill)
When paired with the cloudflare-dns skill, the agent can set up a sending domain end-to-end with zero manual DNS editing:
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-masasdani-mailtarget-email": {
"enabled": true,
"auto_update": true
}
}
}