unione

# UniOne Email API

UniOne is a transactional email service with Web API for sending transactional and marketing emails at scale (up to 3,000 emails/sec). This skill lets you send emails, manage templates, validate addresses, track delivery, and more.

## Authentication

All requests require the `UNIONE_API_KEY` environment variable. Pass it as the `X-API-KEY` header.

**Base URL:** `https://api.unione.io/en/transactional/api/v1/{method}.json?platform=openclaw`

All methods use `POST` with JSON body.

---

## CRITICAL: Domain Setup (Required Before Sending)

**Emails will not be delivered until the sender's domain is verified.** Before attempting to send any email, ensure the domain is set up:

### Step 1: Get DNS Record Values — `domain/get-dns-records.json`

```bash
curl -X POST "https://api.unione.io/en/transactional/api/v1/domain/get-dns-records.json?platform=openclaw" \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: $UNIONE_API_KEY" \
  -d '{"domain": "yourdomain.com"}'
```

**API response** returns raw values (not ready-to-paste DNS records):

```json
{
  "status": "success",
  "domain": "yourdomain.com",
  "verification-record": "unione-validate-hash=483bb362ebdbeedd755cfb1d4d661",
  "dkim": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDo7"
}
```

**The user must create 3 DNS TXT records from these values:**

| Record Host | Record Type | Value |
|-------------|-------------|-------|
| `@` | TXT | `unione-validate-hash=<verification-record from response>` |
| `us._domainkey` | TXT | `k=rsa; p=<dkim from response>` |
| `@` | TXT | `v=spf1 include:spf.unione.io ~all` |

Present these 3 records clearly to the user and instruct them to add them at their DNS provider (Cloudflare, Route53, GoDaddy, etc.). The SPF record is always the same — it is not returned by the API.

### Step 2: Verify Domain Ownership — `domain/validate-verification.json`

After the user has added DNS records:

```bash
curl -X POST "https://api.unione.io/en/transactional/api/v1/domain/val...

# UniOne Email API — OpenClaw Skill

📧 Send transactional and marketing emails via [UniOne](https://unione.io) directly from your AI assistant.

## What this skill does

This skill teaches your AI agent to work with the UniOne Email API. It can:

- **Send emails** — transactional, marketing, personalized with templates
- **Validate email addresses** — check deliverability before sending
- **Manage templates** — create, update, list, delete email templates
- **Track delivery** — set up webhooks for real-time event notifications
- **Manage suppressions** — handle bounces, unsubscribes, complaints
- **Domain management** — check DNS records, verify DKIM
- **Export analytics** — create event dumps for detailed delivery reports
- **Manage projects** — separate environments with independent API keys

## Quick Start

### 1. Get your UniOne API key

Sign up at [cp.unione.io](https://cp.unione.io/en/user/registration/) and get your API key from [account settings](https://cp.unione.io/en/user/info/api).

### 2. Install the skill

**From ClawHub:**
```bash
clawhub install @unione/unione
```

**Manual install:**
```bash
mkdir -p ~/.openclaw/skills/unione
cp SKILL.md ~/.openclaw/skills/unione/
```

### 3. Configure

Add to your `~/.openclaw/openclaw.json`:

```json
{
  "skills": {
    "entries": {
      "unione": {
        "enabled": true,
        "apiKey": "YOUR_UNIONE_API_KEY"
      }
    }
  }
}
```

Or set the environment variable:
```bash
export UNIONE_API_KEY="your-api-key-here"
```

### 4. Use it

Just talk to your AI assistant:

- *"Send a test email to john@example.com"*
- *"Validate this email address: user@domain.com"*
- *"List my email templates"*
- *"Show my domain verification status"*
- *"Set up a webhook for delivery tracking"*
- *"Create an order confirmation template"*

## Requirements

- A [UniOne account](https://cp.unione.io/en/user/registration/) (free plan: 100 emails/day)
- A verified sending domain in UniOne
- `curl` available on your system

## API End...