[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77XAZZJC9M84H2CYS8G3AMF":3,"skill-same:01M77XAZZJC9M84H2CYS8G3AMF":54},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":31,"commitSha":32,"skillDirectory":33,"forksCount":34,"repositoryHtmlUrl":35,"repositoryHomepageUrl":36,"ownerHtmlUrl":37,"ownerBlogUrl":6,"ownerDescription":38,"updatedAt":39,"install":40,"resources":53},"01M77XAZZJC9M84H2CYS8G3AMF","unione",null,"Send transactional and marketing emails via UniOne Email API. Manage email templates, validate email addresses, check delivery statistics, manage suppression lists, configure webhooks, and handle domain settings. UniOne delivers billions of emails annually with 99.88% deliverability.","Lord1Egypt\u002Fawesome-skill-forge","Lord1Egypt","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F99746359?v=4","01M7592YDNT0XK9WJ0T2MQVPDN","Mohamed Mounir Ali AL Keshita","01M75GRFNHC8VZNWEB8DKDE433",3,"MIT","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fu\u002Funione\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: unione\ndescription: >\n  Send transactional and marketing emails via UniOne Email API.\n  Manage email templates, validate email addresses, check delivery statistics,\n  manage suppression lists, configure webhooks, and handle domain settings.\n  UniOne delivers billions of emails annually with 99.88% deliverability.\nmetadata:\n  openclaw:\n    emoji: \"📧\"\n    requires:\n      env:\n        - UNIONE_API_KEY\n    primaryEnv: UNIONE_API_KEY\n---\n\n# UniOne Email API\n\nUniOne is a transactional email service with Web API for sending transactional and marketing emails at scale (up to 3,000 emails\u002Fsec). This skill lets you send emails, manage templates, validate addresses, track delivery, and more.\n\n## Authentication\n\nAll requests require the `UNIONE_API_KEY` environment variable. Pass it as the `X-API-KEY` header.\n\n**Base URL:** `https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002F{method}.json?platform=openclaw`\n\nAll methods use `POST` with JSON body.\n\n---\n\n## CRITICAL: Domain Setup (Required Before Sending)\n\n**Emails will not be delivered until the sender's domain is verified.** Before attempting to send any email, ensure the domain is set up:\n\n### Step 1: Get DNS Record Values — `domain\u002Fget-dns-records.json`\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Fdomain\u002Fget-dns-records.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\"domain\": \"yourdomain.com\"}'\n```\n\n**API response** returns raw values (not ready-to-paste DNS records):\n\n```json\n{\n  \"status\": \"success\",\n  \"domain\": \"yourdomain.com\",\n  \"verification-record\": \"unione-validate-hash=483bb362ebdbeedd755cfb1d4d661\",\n  \"dkim\": \"MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDo7\"\n}\n```\n\n**The user must create 3 DNS TXT records from these values:**\n\n| Record Host | Record Type | Value |\n|-------------|-------------|-------|\n| `@` | TXT | `unione-validate-hash=\u003Cverification-record from response>` |\n| `us._domainkey` | TXT | `k=rsa; p=\u003Cdkim from response>` |\n| `@` | TXT | `v=spf1 include:spf.unione.io ~all` |\n\nPresent 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.\n\n### Step 2: Verify Domain Ownership — `domain\u002Fvalidate-verification.json`\n\nAfter the user has added DNS records:\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Fdomain\u002Fvalidate-verification.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\"domain\": \"yourdomain.com\"}'\n```\n\n### Step 3: Validate DKIM — `domain\u002Fvalidate-dkim.json`\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Fdomain\u002Fvalidate-dkim.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\"domain\": \"yourdomain.com\"}'\n```\n\n### Step 4: List All Domains — `domain\u002Flist.json`\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Fdomain\u002Flist.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{}'\n```\n\n**If domain verification fails:** DNS propagation can take up to 48 hours. Suggest the user waits and retries, or checks their DNS records for typos.\n\n---\n\n## Error Handling & Retry Policy\n\n### Retry Logic\n\nWhen making API requests, implement exponential backoff for retryable errors:\n\n**Retryable errors (DO retry with exponential backoff):**\n\n| HTTP Code | Meaning | Retry Strategy |\n|-----------|---------|----------------|\n| 429 | Rate limited | Wait, then retry. Respect `Retry-After` header if present |\n| 500 | Internal server error | Retry up to 3 times |\n| 502 | Bad gateway | Retry up to 3 times |\n| 503 | Service unavailable | Retry up to 3 times |\n| 504 | Gateway timeout | Retry up to 3 times |\n\n**Recommended retry schedule:**\n\n| Attempt | Delay |\n|---------|-------|\n| 1 | Immediate |\n| 2 | 1 second |\n| 3 | 5 seconds |\n| 4 | 30 seconds |\n\n**Non-retryable errors (do NOT retry):**\n\n| HTTP Code | Meaning | Action |\n|-----------|---------|--------|\n| 400 | Bad request | Fix the request parameters |\n| 401 | Unauthorized | Check API key |\n| 403 | Forbidden | Check permissions \u002F domain verification |\n| 404 | Endpoint not found | Check the method path |\n| 413 | Payload too large | Reduce request size |\n\n### Idempotency\n\nFor `email\u002Fsend.json`, always include an `idempotency_key` to prevent duplicate sends during retries. This is critical for production systems.\n\nThe `idempotency_key` is a unique string (UUID recommended) passed in the request body. If UniOne receives two requests with the same key, the second request returns the result of the first without sending another email.\n\n**Always generate a unique idempotency key per logical send operation, and reuse the same key when retrying the same send.**\n\n---\n\n## 1. Send Email — `email\u002Fsend.json`\n\nSend a transactional or marketing email to one or more recipients. Supports personalization via substitutions, templates, attachments, tracking, and metadata.\n\n### curl\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Femail\u002Fsend.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\n    \"idempotency_key\": \"unique-uuid-here\",\n    \"message\": {\n      \"recipients\": [\n        {\n          \"email\": \"recipient@example.com\",\n          \"substitutions\": {\n            \"to_name\": \"John Smith\"\n          }\n        }\n      ],\n      \"body\": {\n        \"html\": \"\u003Ch1>Hello, {{to_name}}!\u003C\u002Fh1>\u003Cp>Your order has been confirmed.\u003C\u002Fp>\",\n        \"plaintext\": \"Hello, {{to_name}}! Your order has been confirmed.\"\n      },\n      \"subject\": \"Order Confirmation\",\n      \"from_email\": \"noreply@yourdomain.com\",\n      \"from_name\": \"Your Store\"\n    }\n  }'\n```\n\n### Node.js\n\n```javascript\nconst response = await fetch(\"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Femail\u002Fsend.json?platform=openclaw\", {\n  method: \"POST\",\n  headers: {\n    \"Content-Type\": \"application\u002Fjson\",\n    \"X-API-KEY\": process.env.UNIONE_API_KEY\n  },\n  body: JSON.stringify({\n    idempotency_key: crypto.randomUUID(),\n    message: {\n      recipients: [{ email: \"recipient@example.com\", substitutions: { to_name: \"John\" } }],\n      body: {\n        html: \"\u003Ch1>Hello, {{to_name}}!\u003C\u002Fh1>\u003Cp>Your order has been confirmed.\u003C\u002Fp>\",\n        plaintext: \"Hello, {{to_name}}! Your order has been confirmed.\"\n      },\n      subject: \"Order Confirmation\",\n      from_email: \"noreply@yourdomain.com\",\n      from_name: \"Your Store\"\n    }\n  })\n});\nconst data = await response.json();\n\u002F\u002F data.status === \"success\" → data.job_id, data.emails\n```\n\n### Python\n\n```python\nimport requests, uuid, os\n\nresponse = requests.post(\n    \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Femail\u002Fsend.json?platform=openclaw\",\n    headers={\n        \"Content-Type\": \"application\u002Fjson\",\n        \"X-API-KEY\": os.environ[\"UNIONE_API_KEY\"]\n    },\n    json={\n        \"idempotency_key\": str(uuid.uuid4()),\n        \"message\": {\n            \"recipients\": [{\"email\": \"recipient@example.com\", \"substitutions\": {\"to_name\": \"John\"}}],\n            \"body\": {\n                \"html\": \"\u003Ch1>Hello, {{to_name}}!\u003C\u002Fh1>\u003Cp>Your order has been confirmed.\u003C\u002Fp>\",\n                \"plaintext\": \"Hello, {{to_name}}! Your order has been confirmed.\"\n            },\n            \"subject\": \"Order Confirmation\",\n            \"from_email\": \"noreply@yourdomain.com\",\n            \"from_name\": \"Your Store\"\n        }\n    }\n)\ndata = response.json()  # data[\"status\"] == \"success\" → data[\"job_id\"], data[\"emails\"]\n```\n\n### Go\n\n```go\npackage main\n\nimport (\n    \"bytes\"\n    \"encoding\u002Fjson\"\n    \"fmt\"\n    \"net\u002Fhttp\"\n    \"os\"\n    \"github.com\u002Fgoogle\u002Fuuid\"\n)\n\nfunc sendEmail() error {\n    payload := map[string]interface{}{\n        \"idempotency_key\": uuid.New().String(),\n        \"message\": map[string]interface{}{\n            \"recipients\": []map[string]interface{}{\n                {\"email\": \"recipient@example.com\", \"substitutions\": map[string]string{\"to_name\": \"John\"}},\n            },\n            \"body\": map[string]string{\n                \"html\":      \"\u003Ch1>Hello, {{to_name}}!\u003C\u002Fh1>\u003Cp>Your order has been confirmed.\u003C\u002Fp>\",\n                \"plaintext\": \"Hello, {{to_name}}! Your order has been confirmed.\",\n            },\n            \"subject\":    \"Order Confirmation\",\n            \"from_email\": \"noreply@yourdomain.com\",\n            \"from_name\":  \"Your Store\",\n        },\n    }\n    body, _ := json.Marshal(payload)\n    req, _ := http.NewRequest(\"POST\",\n        \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Femail\u002Fsend.json?platform=openclaw\",\n        bytes.NewReader(body))\n    req.Header.Set(\"Content-Type\", \"application\u002Fjson\")\n    req.Header.Set(\"X-API-KEY\", os.Getenv(\"UNIONE_API_KEY\"))\n    resp, err := http.DefaultClient.Do(req)\n    if err != nil {\n        return err\n    }\n    defer resp.Body.Close()\n    var result map[string]interface{}\n    json.NewDecoder(resp.Body).Decode(&result)\n    fmt.Println(result) \u002F\u002F result[\"status\"] == \"success\"\n    return nil\n}\n```\n\n### PHP\n\n```php\n$ch = curl_init(\"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Femail\u002Fsend.json?platform=openclaw\");\ncurl_setopt_array($ch, [\n    CURLOPT_POST => true,\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        \"Content-Type: application\u002Fjson\",\n        \"X-API-KEY: \" . getenv(\"UNIONE_API_KEY\")\n    ],\n    CURLOPT_POSTFIELDS => json_encode([\n        \"idempotency_key\" => bin2hex(random_bytes(16)),\n        \"message\" => [\n            \"recipients\" => [[\"email\" => \"recipient@example.com\", \"substitutions\" => [\"to_name\" => \"John\"]]],\n            \"body\" => [\n                \"html\" => \"\u003Ch1>Hello, {{to_name}}!\u003C\u002Fh1>\u003Cp>Your order has been confirmed.\u003C\u002Fp>\",\n                \"plaintext\" => \"Hello, {{to_name}}! Your order has been confirmed.\"\n            ],\n            \"subject\" => \"Order Confirmation\",\n            \"from_email\" => \"noreply@yourdomain.com\",\n            \"from_name\" => \"Your Store\"\n        ]\n    ])\n]);\n$response = curl_exec($ch);\n$data = json_decode($response, true); \u002F\u002F $data[\"status\"] === \"success\"\n```\n\n**Success response:**\n```json\n{\n  \"status\": \"success\",\n  \"job_id\": \"1ZymBc-00041N-9X\",\n  \"emails\": [\"recipient@example.com\"]\n}\n```\n\n**Full parameters for `message` object:**\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `recipients` | array | Yes | Array of recipient objects. Each has `email` (required), `substitutions` (object), `metadata` (object) |\n| `body.html` | string | Yes* | HTML content. Use `{{variable}}` for substitutions |\n| `body.plaintext` | string | No | Plain text version |\n| `subject` | string | Yes* | Email subject line. Supports `{{substitutions}}` |\n| `from_email` | string | Yes* | Sender email (must be from a verified domain) |\n| `from_name` | string | No | Sender display name |\n| `reply_to` | string | No | Reply-to email address |\n| `template_id` | string | No | Use a stored template instead of body\u002Fsubject |\n| `tags` | array | No | Tags for categorizing and filtering |\n| `track_links` | 0\u002F1 | No | Enable click tracking (default: 0) |\n| `track_read` | 0\u002F1 | No | Enable open tracking (default: 0) |\n| `global_language` | string | No | Language for unsubscribe footer: en, de, fr, es, it, pl, pt, ru, ua, be |\n| `template_engine` | string | No | `\"simple\"` (default) or `\"velocity\"` or `\"liquid\"` |\n| `global_substitutions` | object | No | Variables available to all recipients |\n| `attachments` | array | No | Array of `{type, name, content}` where content is base64 |\n| `skip_unsubscribe` | 0\u002F1 | No | Skip unsubscribe footer (use 1 only for transactional) |\n| `headers` | object | No | Custom email headers |\n\n*Not required if `template_id` is used.\n\n**Top-level parameter:**\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `idempotency_key` | string | Recommended | Unique key (UUID) to prevent duplicate sends on retry. Max 36 chars. |\n\n**Send with template:**\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Femail\u002Fsend.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\n    \"idempotency_key\": \"unique-uuid-here\",\n    \"message\": {\n      \"recipients\": [\n        {\n          \"email\": \"customer@example.com\",\n          \"substitutions\": {\n            \"to_name\": \"Alice\",\n            \"order_id\": \"ORD-12345\",\n            \"total\": \"$59.99\"\n          }\n        }\n      ],\n      \"template_id\": \"your-template-id\",\n      \"from_email\": \"shop@yourdomain.com\",\n      \"from_name\": \"My Shop\"\n    }\n  }'\n```\n\n**Send to multiple recipients with personalization:**\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Femail\u002Fsend.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\n    \"idempotency_key\": \"unique-uuid-here\",\n    \"message\": {\n      \"recipients\": [\n        {\"email\": \"alice@example.com\", \"substitutions\": {\"to_name\": \"Alice\"}},\n        {\"email\": \"bob@example.com\", \"substitutions\": {\"to_name\": \"Bob\"}}\n      ],\n      \"body\": {\n        \"html\": \"\u003Cp>Hi {{to_name}}, check out our new {{promo_name}}!\u003C\u002Fp>\"\n      },\n      \"subject\": \"Special offer for you, {{to_name}}!\",\n      \"from_email\": \"marketing@yourdomain.com\",\n      \"from_name\": \"Marketing Team\",\n      \"global_substitutions\": {\"promo_name\": \"Summer Sale\"},\n      \"track_links\": 1,\n      \"track_read\": 1,\n      \"tags\": [\"promo\", \"summer-2026\"]\n    }\n  }'\n```\n\n---\n\n## 2. Email Validation — `email-validation\u002Fsingle.json`\n\nValidate an email address to check if it exists and is deliverable.\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Femail-validation\u002Fsingle.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\"email\": \"user@example.com\"}'\n```\n\n**Response:**\n```json\n{\n  \"status\": \"success\",\n  \"email\": \"user@example.com\",\n  \"result\": \"valid\",\n  \"local_part\": \"user\",\n  \"domain\": \"example.com\",\n  \"mx_found\": true,\n  \"mx_record\": \"mail.example.com\"\n}\n```\n\nPossible `result` values: `\"valid\"`, `\"invalid\"`, `\"unresolvable\"`, `\"unknown\"`.\n\n---\n\n## 3. Template Management\n\n### 3.1 Create\u002FUpdate Template — `template\u002Fset.json`\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Ftemplate\u002Fset.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\n    \"template\": {\n      \"name\": \"Order Confirmation\",\n      \"subject\": \"Your order {{order_id}} is confirmed\",\n      \"template_engine\": \"simple\",\n      \"body\": {\n        \"html\": \"\u003Ch1>Thank you, {{to_name}}!\u003C\u002Fh1>\u003Cp>Order {{order_id}} total: {{total}}\u003C\u002Fp>\",\n        \"plaintext\": \"Thank you, {{to_name}}! Order {{order_id}} total: {{total}}\"\n      },\n      \"from_email\": \"shop@yourdomain.com\",\n      \"from_name\": \"My Shop\"\n    }\n  }'\n```\n\n**Response:** `{\"status\": \"success\", \"template\": {\"id\": \"generated-template-id\"}}`\n\nTo **update** an existing template, include the `\"id\"` field in the template object.\n\n### 3.2 Get Template — `template\u002Fget.json`\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Ftemplate\u002Fget.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\"id\": \"template-id-here\"}'\n```\n\n### 3.3 List Templates — `template\u002Flist.json`\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Ftemplate\u002Flist.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\"limit\": 50, \"offset\": 0}'\n```\n\n### 3.4 Delete Template — `template\u002Fdelete.json`\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Ftemplate\u002Fdelete.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\"id\": \"template-id-here\"}'\n```\n\n---\n\n## 4. Webhook Management\n\nWebhooks send real-time notifications about email events to your URL.\n\n### 4.1 Set Webhook — `webhook\u002Fset.json`\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Fwebhook\u002Fset.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\n    \"url\": \"https:\u002F\u002Fyourapp.com\u002Funione-webhook\",\n    \"events\": {\n      \"email_status\": [\n        \"delivered\", \"opened\", \"clicked\", \"unsubscribed\",\n        \"soft_bounced\", \"hard_bounced\", \"spam\"\n      ]\n    }\n  }'\n```\n\n### 4.2 List Webhooks — `webhook\u002Flist.json`\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Fwebhook\u002Flist.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{}'\n```\n\n### 4.3 Get \u002F Delete Webhook — `webhook\u002Fget.json` \u002F `webhook\u002Fdelete.json`\n\n```bash\n# Get\ncurl -X POST \"...\u002Fwebhook\u002Fget.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{\"url\": \"https:\u002F\u002Fyourapp.com\u002Funione-webhook\"}'\n\n# Delete\ncurl -X POST \"...\u002Fwebhook\u002Fdelete.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{\"url\": \"https:\u002F\u002Fyourapp.com\u002Funione-webhook\"}'\n```\n\n---\n\n## 5. Suppression List Management\n\n### 5.1 Add — `suppression\u002Fset.json`\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Fsuppression\u002Fset.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\"email\": \"user@example.com\", \"cause\": \"unsubscribed\", \"created\": \"2026-01-15 12:00:00\"}'\n```\n\nCause values: `\"unsubscribed\"`, `\"temporary_unavailable\"`, `\"permanent_unavailable\"`, `\"complained\"`.\n\n### 5.2 Check — `suppression\u002Fget.json`\n\n```bash\ncurl -X POST \"...\u002Fsuppression\u002Fget.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{\"email\": \"user@example.com\"}'\n```\n\n### 5.3 List — `suppression\u002Flist.json`\n\n```bash\ncurl -X POST \"...\u002Fsuppression\u002Flist.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{\"cause\": \"hard_bounced\", \"limit\": 50, \"offset\": 0}'\n```\n\n### 5.4 Delete — `suppression\u002Fdelete.json`\n\n```bash\ncurl -X POST \"...\u002Fsuppression\u002Fdelete.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{\"email\": \"user@example.com\"}'\n```\n\n---\n\n## 6. Event Dumps\n\n### 6.1 Create — `event-dump\u002Fcreate.json`\n\n```bash\ncurl -X POST \"...\u002Fevent-dump\u002Fcreate.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"start_time\": \"2026-01-01 00:00:00\", \"end_time\": \"2026-01-31 23:59:59\", \"limit\": 50000, \"all_events\": true}'\n```\n\n### 6.2 Get \u002F List \u002F Delete\n\n```bash\n# Get dump status and download URL\ncurl -X POST \"...\u002Fevent-dump\u002Fget.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{\"dump_id\": \"dump-id\"}'\n\n# List all dumps\ncurl -X POST \"...\u002Fevent-dump\u002Flist.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{}'\n\n# Delete a dump\ncurl -X POST \"...\u002Fevent-dump\u002Fdelete.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{\"dump_id\": \"dump-id\"}'\n```\n\n---\n\n## 7. Tags — `tag\u002Flist.json` \u002F `tag\u002Fdelete.json`\n\n```bash\n# List tags\ncurl -X POST \"...\u002Ftag\u002Flist.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{}'\n\n# Delete tag\ncurl -X POST \"...\u002Ftag\u002Fdelete.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{\"tag_id\": 123}'\n```\n\n---\n\n## 8. Projects — `project\u002Fcreate.json` \u002F `project\u002Flist.json`\n\n```bash\n# Create project\ncurl -X POST \"...\u002Fproject\u002Fcreate.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"project\": {\"name\": \"My Project\", \"send_enabled\": true}}'\n\n# List projects\ncurl -X POST \"...\u002Fproject\u002Flist.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{}'\n```\n\n---\n\n## 9. System Info — `system\u002Finfo.json`\n\n```bash\ncurl -X POST \"...\u002Fsystem\u002Finfo.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{}'\n```\n\n---\n\n## 10. Subscribe (Double Opt-In) — `email\u002Fsubscribe.json`\n\n```bash\ncurl -X POST \"...\u002Femail\u002Fsubscribe.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"from_email\": \"newsletter@yourdomain.com\", \"from_name\": \"Newsletter\", \"to_email\": \"newsubscriber@example.com\"}'\n```\n\n---\n\n## Instructions for the Agent\n\n1. **Domain setup is mandatory.** Before the first send, always check if the user's domain is verified. Run `domain\u002Flist.json` to check. If not verified, guide them through the domain setup process (Section: Domain Setup).\n2. **Always use `api.unione.io`** as the API host for all requests.\n3. **Never send an email without explicit user confirmation.** Always show the recipient, subject, and body summary before executing `email\u002Fsend.json`.\n4. **Always include `idempotency_key`** in `email\u002Fsend.json` requests. Generate a UUID for each unique send. Reuse the same key when retrying.\n5. **Implement retry logic** for 429 and 5xx errors with exponential backoff (see Error Handling section). Never retry 400, 401, 403, 404, 413 errors.\n6. **For template operations**, list available templates first before asking which one to use.\n7. **For validation**, report the result clearly and suggest action.\n8. **Handle errors gracefully.** If a request returns an error, explain what went wrong and suggest a fix.\n9. **Remind users** that the `from_email` domain must be verified in their UniOne account.\n10. **Substitution syntax** uses double curly braces: `{{variable_name}}`.\n11. **Attachments** must be base64-encoded. Help the user encode files if needed.\n12. **Security**: Never log or display the full API key. Remind users to keep their API key secret.\n13. **Code language**: When the user's project uses a specific language (Node.js, Python, Go, PHP, etc.), provide code examples in that language. The examples in this skill can be adapted to any language that can make HTTP POST requests with JSON.\n\n## Common Workflows\n\n### \"Send a test email\"\n1. Check domain verification (`domain\u002Flist.json`)\n2. If domain not verified, guide through domain setup\n3. Ask for recipient email address\n4. Compose a simple test message\n5. Confirm with user before sending\n6. Execute `email\u002Fsend.json` with `idempotency_key`\n7. Report the job_id on success\n\n### \"Check my deliverability setup\"\n1. Run `system\u002Finfo.json` to get account status\n2. Run `domain\u002Flist.json` to check domain verification\n3. For each unverified domain, run `domain\u002Fget-dns-records.json` and show required records\n4. Run `domain\u002Fvalidate-dkim.json` to check DKIM\n5. Suggest fixes if domains are not fully verified\n\n### \"Validate a list of emails\"\n1. For each email, call `email-validation\u002Fsingle.json`\n2. Categorize results: valid, invalid, unknown\n3. Report summary\n\n### \"Set up delivery tracking\"\n1. Ask for webhook URL and events to track\n2. Execute `webhook\u002Fset.json`\n3. Confirm setup\n\n## Resources\n\n- Full API Reference: https:\u002F\u002Fdocs.unione.io\u002Fen\u002Fweb-api-ref\n- Getting Started: https:\u002F\u002Fdocs.unione.io\u002Fen\u002F\n- Template Engines: https:\u002F\u002Fdocs.unione.io\u002Fen\u002Fweb-api#section-template-engines\n- Sign Up: https:\u002F\u002Fcp.unione.io\u002Fen\u002Fuser\u002Fregistration\u002F\n","# UniOne Email API\n\nUniOne is a transactional email service with Web API for sending transactional and marketing emails at scale (up to 3,000 emails\u002Fsec). This skill lets you send emails, manage templates, validate addresses, track delivery, and more.\n\n## Authentication\n\nAll requests require the `UNIONE_API_KEY` environment variable. Pass it as the `X-API-KEY` header.\n\n**Base URL:** `https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002F{method}.json?platform=openclaw`\n\nAll methods use `POST` with JSON body.\n\n---\n\n## CRITICAL: Domain Setup (Required Before Sending)\n\n**Emails will not be delivered until the sender's domain is verified.** Before attempting to send any email, ensure the domain is set up:\n\n### Step 1: Get DNS Record Values — `domain\u002Fget-dns-records.json`\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Fdomain\u002Fget-dns-records.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\"domain\": \"yourdomain.com\"}'\n```\n\n**API response** returns raw values (not ready-to-paste DNS records):\n\n```json\n{\n  \"status\": \"success\",\n  \"domain\": \"yourdomain.com\",\n  \"verification-record\": \"unione-validate-hash=483bb362ebdbeedd755cfb1d4d661\",\n  \"dkim\": \"MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDo7\"\n}\n```\n\n**The user must create 3 DNS TXT records from these values:**\n\n| Record Host | Record Type | Value |\n|-------------|-------------|-------|\n| `@` | TXT | `unione-validate-hash=\u003Cverification-record from response>` |\n| `us._domainkey` | TXT | `k=rsa; p=\u003Cdkim from response>` |\n| `@` | TXT | `v=spf1 include:spf.unione.io ~all` |\n\nPresent 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.\n\n### Step 2: Verify Domain Ownership — `domain\u002Fvalidate-verification.json`\n\nAfter the user has added DNS records:\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Fdomain\u002Fvalidate-verification.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\"domain\": \"yourdomain.com\"}'\n```\n\n### Step 3: Validate DKIM — `domain\u002Fvalidate-dkim.json`\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Fdomain\u002Fvalidate-dkim.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\"domain\": \"yourdomain.com\"}'\n```\n\n### Step 4: List All Domains — `domain\u002Flist.json`\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Fdomain\u002Flist.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{}'\n```\n\n**If domain verification fails:** DNS propagation can take up to 48 hours. Suggest the user waits and retries, or checks their DNS records for typos.\n\n---\n\n## Error Handling & Retry Policy\n\n### Retry Logic\n\nWhen making API requests, implement exponential backoff for retryable errors:\n\n**Retryable errors (DO retry with exponential backoff):**\n\n| HTTP Code | Meaning | Retry Strategy |\n|-----------|---------|----------------|\n| 429 | Rate limited | Wait, then retry. Respect `Retry-After` header if present |\n| 500 | Internal server error | Retry up to 3 times |\n| 502 | Bad gateway | Retry up to 3 times |\n| 503 | Service unavailable | Retry up to 3 times |\n| 504 | Gateway timeout | Retry up to 3 times |\n\n**Recommended retry schedule:**\n\n| Attempt | Delay |\n|---------|-------|\n| 1 | Immediate |\n| 2 | 1 second |\n| 3 | 5 seconds |\n| 4 | 30 seconds |\n\n**Non-retryable errors (do NOT retry):**\n\n| HTTP Code | Meaning | Action |\n|-----------|---------|--------|\n| 400 | Bad request | Fix the request parameters |\n| 401 | Unauthorized | Check API key |\n| 403 | Forbidden | Check permissions \u002F domain verification |\n| 404 | Endpoint not found | Check the method path |\n| 413 | Payload too large | Reduce request size |\n\n### Idempotency\n\nFor `email\u002Fsend.json`, always include an `idempotency_key` to prevent duplicate sends during retries. This is critical for production systems.\n\nThe `idempotency_key` is a unique string (UUID recommended) passed in the request body. If UniOne receives two requests with the same key, the second request returns the result of the first without sending another email.\n\n**Always generate a unique idempotency key per logical send operation, and reuse the same key when retrying the same send.**\n\n---\n\n## 1. Send Email — `email\u002Fsend.json`\n\nSend a transactional or marketing email to one or more recipients. Supports personalization via substitutions, templates, attachments, tracking, and metadata.\n\n### curl\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Femail\u002Fsend.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\n    \"idempotency_key\": \"unique-uuid-here\",\n    \"message\": {\n      \"recipients\": [\n        {\n          \"email\": \"recipient@example.com\",\n          \"substitutions\": {\n            \"to_name\": \"John Smith\"\n          }\n        }\n      ],\n      \"body\": {\n        \"html\": \"\u003Ch1>Hello, {{to_name}}!\u003C\u002Fh1>\u003Cp>Your order has been confirmed.\u003C\u002Fp>\",\n        \"plaintext\": \"Hello, {{to_name}}! Your order has been confirmed.\"\n      },\n      \"subject\": \"Order Confirmation\",\n      \"from_email\": \"noreply@yourdomain.com\",\n      \"from_name\": \"Your Store\"\n    }\n  }'\n```\n\n### Node.js\n\n```javascript\nconst response = await fetch(\"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Femail\u002Fsend.json?platform=openclaw\", {\n  method: \"POST\",\n  headers: {\n    \"Content-Type\": \"application\u002Fjson\",\n    \"X-API-KEY\": process.env.UNIONE_API_KEY\n  },\n  body: JSON.stringify({\n    idempotency_key: crypto.randomUUID(),\n    message: {\n      recipients: [{ email: \"recipient@example.com\", substitutions: { to_name: \"John\" } }],\n      body: {\n        html: \"\u003Ch1>Hello, {{to_name}}!\u003C\u002Fh1>\u003Cp>Your order has been confirmed.\u003C\u002Fp>\",\n        plaintext: \"Hello, {{to_name}}! Your order has been confirmed.\"\n      },\n      subject: \"Order Confirmation\",\n      from_email: \"noreply@yourdomain.com\",\n      from_name: \"Your Store\"\n    }\n  })\n});\nconst data = await response.json();\n\u002F\u002F data.status === \"success\" → data.job_id, data.emails\n```\n\n### Python\n\n```python\nimport requests, uuid, os\n\nresponse = requests.post(\n    \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Femail\u002Fsend.json?platform=openclaw\",\n    headers={\n        \"Content-Type\": \"application\u002Fjson\",\n        \"X-API-KEY\": os.environ[\"UNIONE_API_KEY\"]\n    },\n    json={\n        \"idempotency_key\": str(uuid.uuid4()),\n        \"message\": {\n            \"recipients\": [{\"email\": \"recipient@example.com\", \"substitutions\": {\"to_name\": \"John\"}}],\n            \"body\": {\n                \"html\": \"\u003Ch1>Hello, {{to_name}}!\u003C\u002Fh1>\u003Cp>Your order has been confirmed.\u003C\u002Fp>\",\n                \"plaintext\": \"Hello, {{to_name}}! Your order has been confirmed.\"\n            },\n            \"subject\": \"Order Confirmation\",\n            \"from_email\": \"noreply@yourdomain.com\",\n            \"from_name\": \"Your Store\"\n        }\n    }\n)\ndata = response.json()  # data[\"status\"] == \"success\" → data[\"job_id\"], data[\"emails\"]\n```\n\n### Go\n\n```go\npackage main\n\nimport (\n    \"bytes\"\n    \"encoding\u002Fjson\"\n    \"fmt\"\n    \"net\u002Fhttp\"\n    \"os\"\n    \"github.com\u002Fgoogle\u002Fuuid\"\n)\n\nfunc sendEmail() error {\n    payload := map[string]interface{}{\n        \"idempotency_key\": uuid.New().String(),\n        \"message\": map[string]interface{}{\n            \"recipients\": []map[string]interface{}{\n                {\"email\": \"recipient@example.com\", \"substitutions\": map[string]string{\"to_name\": \"John\"}},\n            },\n            \"body\": map[string]string{\n                \"html\":      \"\u003Ch1>Hello, {{to_name}}!\u003C\u002Fh1>\u003Cp>Your order has been confirmed.\u003C\u002Fp>\",\n                \"plaintext\": \"Hello, {{to_name}}! Your order has been confirmed.\",\n            },\n            \"subject\":    \"Order Confirmation\",\n            \"from_email\": \"noreply@yourdomain.com\",\n            \"from_name\":  \"Your Store\",\n        },\n    }\n    body, _ := json.Marshal(payload)\n    req, _ := http.NewRequest(\"POST\",\n        \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Femail\u002Fsend.json?platform=openclaw\",\n        bytes.NewReader(body))\n    req.Header.Set(\"Content-Type\", \"application\u002Fjson\")\n    req.Header.Set(\"X-API-KEY\", os.Getenv(\"UNIONE_API_KEY\"))\n    resp, err := http.DefaultClient.Do(req)\n    if err != nil {\n        return err\n    }\n    defer resp.Body.Close()\n    var result map[string]interface{}\n    json.NewDecoder(resp.Body).Decode(&result)\n    fmt.Println(result) \u002F\u002F result[\"status\"] == \"success\"\n    return nil\n}\n```\n\n### PHP\n\n```php\n$ch = curl_init(\"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Femail\u002Fsend.json?platform=openclaw\");\ncurl_setopt_array($ch, [\n    CURLOPT_POST => true,\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        \"Content-Type: application\u002Fjson\",\n        \"X-API-KEY: \" . getenv(\"UNIONE_API_KEY\")\n    ],\n    CURLOPT_POSTFIELDS => json_encode([\n        \"idempotency_key\" => bin2hex(random_bytes(16)),\n        \"message\" => [\n            \"recipients\" => [[\"email\" => \"recipient@example.com\", \"substitutions\" => [\"to_name\" => \"John\"]]],\n            \"body\" => [\n                \"html\" => \"\u003Ch1>Hello, {{to_name}}!\u003C\u002Fh1>\u003Cp>Your order has been confirmed.\u003C\u002Fp>\",\n                \"plaintext\" => \"Hello, {{to_name}}! Your order has been confirmed.\"\n            ],\n            \"subject\" => \"Order Confirmation\",\n            \"from_email\" => \"noreply@yourdomain.com\",\n            \"from_name\" => \"Your Store\"\n        ]\n    ])\n]);\n$response = curl_exec($ch);\n$data = json_decode($response, true); \u002F\u002F $data[\"status\"] === \"success\"\n```\n\n**Success response:**\n```json\n{\n  \"status\": \"success\",\n  \"job_id\": \"1ZymBc-00041N-9X\",\n  \"emails\": [\"recipient@example.com\"]\n}\n```\n\n**Full parameters for `message` object:**\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `recipients` | array | Yes | Array of recipient objects. Each has `email` (required), `substitutions` (object), `metadata` (object) |\n| `body.html` | string | Yes* | HTML content. Use `{{variable}}` for substitutions |\n| `body.plaintext` | string | No | Plain text version |\n| `subject` | string | Yes* | Email subject line. Supports `{{substitutions}}` |\n| `from_email` | string | Yes* | Sender email (must be from a verified domain) |\n| `from_name` | string | No | Sender display name |\n| `reply_to` | string | No | Reply-to email address |\n| `template_id` | string | No | Use a stored template instead of body\u002Fsubject |\n| `tags` | array | No | Tags for categorizing and filtering |\n| `track_links` | 0\u002F1 | No | Enable click tracking (default: 0) |\n| `track_read` | 0\u002F1 | No | Enable open tracking (default: 0) |\n| `global_language` | string | No | Language for unsubscribe footer: en, de, fr, es, it, pl, pt, ru, ua, be |\n| `template_engine` | string | No | `\"simple\"` (default) or `\"velocity\"` or `\"liquid\"` |\n| `global_substitutions` | object | No | Variables available to all recipients |\n| `attachments` | array | No | Array of `{type, name, content}` where content is base64 |\n| `skip_unsubscribe` | 0\u002F1 | No | Skip unsubscribe footer (use 1 only for transactional) |\n| `headers` | object | No | Custom email headers |\n\n*Not required if `template_id` is used.\n\n**Top-level parameter:**\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `idempotency_key` | string | Recommended | Unique key (UUID) to prevent duplicate sends on retry. Max 36 chars. |\n\n**Send with template:**\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Femail\u002Fsend.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\n    \"idempotency_key\": \"unique-uuid-here\",\n    \"message\": {\n      \"recipients\": [\n        {\n          \"email\": \"customer@example.com\",\n          \"substitutions\": {\n            \"to_name\": \"Alice\",\n            \"order_id\": \"ORD-12345\",\n            \"total\": \"$59.99\"\n          }\n        }\n      ],\n      \"template_id\": \"your-template-id\",\n      \"from_email\": \"shop@yourdomain.com\",\n      \"from_name\": \"My Shop\"\n    }\n  }'\n```\n\n**Send to multiple recipients with personalization:**\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Femail\u002Fsend.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\n    \"idempotency_key\": \"unique-uuid-here\",\n    \"message\": {\n      \"recipients\": [\n        {\"email\": \"alice@example.com\", \"substitutions\": {\"to_name\": \"Alice\"}},\n        {\"email\": \"bob@example.com\", \"substitutions\": {\"to_name\": \"Bob\"}}\n      ],\n      \"body\": {\n        \"html\": \"\u003Cp>Hi {{to_name}}, check out our new {{promo_name}}!\u003C\u002Fp>\"\n      },\n      \"subject\": \"Special offer for you, {{to_name}}!\",\n      \"from_email\": \"marketing@yourdomain.com\",\n      \"from_name\": \"Marketing Team\",\n      \"global_substitutions\": {\"promo_name\": \"Summer Sale\"},\n      \"track_links\": 1,\n      \"track_read\": 1,\n      \"tags\": [\"promo\", \"summer-2026\"]\n    }\n  }'\n```\n\n---\n\n## 2. Email Validation — `email-validation\u002Fsingle.json`\n\nValidate an email address to check if it exists and is deliverable.\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Femail-validation\u002Fsingle.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\"email\": \"user@example.com\"}'\n```\n\n**Response:**\n```json\n{\n  \"status\": \"success\",\n  \"email\": \"user@example.com\",\n  \"result\": \"valid\",\n  \"local_part\": \"user\",\n  \"domain\": \"example.com\",\n  \"mx_found\": true,\n  \"mx_record\": \"mail.example.com\"\n}\n```\n\nPossible `result` values: `\"valid\"`, `\"invalid\"`, `\"unresolvable\"`, `\"unknown\"`.\n\n---\n\n## 3. Template Management\n\n### 3.1 Create\u002FUpdate Template — `template\u002Fset.json`\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Ftemplate\u002Fset.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\n    \"template\": {\n      \"name\": \"Order Confirmation\",\n      \"subject\": \"Your order {{order_id}} is confirmed\",\n      \"template_engine\": \"simple\",\n      \"body\": {\n        \"html\": \"\u003Ch1>Thank you, {{to_name}}!\u003C\u002Fh1>\u003Cp>Order {{order_id}} total: {{total}}\u003C\u002Fp>\",\n        \"plaintext\": \"Thank you, {{to_name}}! Order {{order_id}} total: {{total}}\"\n      },\n      \"from_email\": \"shop@yourdomain.com\",\n      \"from_name\": \"My Shop\"\n    }\n  }'\n```\n\n**Response:** `{\"status\": \"success\", \"template\": {\"id\": \"generated-template-id\"}}`\n\nTo **update** an existing template, include the `\"id\"` field in the template object.\n\n### 3.2 Get Template — `template\u002Fget.json`\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Ftemplate\u002Fget.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\"id\": \"template-id-here\"}'\n```\n\n### 3.3 List Templates — `template\u002Flist.json`\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Ftemplate\u002Flist.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\"limit\": 50, \"offset\": 0}'\n```\n\n### 3.4 Delete Template — `template\u002Fdelete.json`\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Ftemplate\u002Fdelete.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\"id\": \"template-id-here\"}'\n```\n\n---\n\n## 4. Webhook Management\n\nWebhooks send real-time notifications about email events to your URL.\n\n### 4.1 Set Webhook — `webhook\u002Fset.json`\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Fwebhook\u002Fset.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\n    \"url\": \"https:\u002F\u002Fyourapp.com\u002Funione-webhook\",\n    \"events\": {\n      \"email_status\": [\n        \"delivered\", \"opened\", \"clicked\", \"unsubscribed\",\n        \"soft_bounced\", \"hard_bounced\", \"spam\"\n      ]\n    }\n  }'\n```\n\n### 4.2 List Webhooks — `webhook\u002Flist.json`\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Fwebhook\u002Flist.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{}'\n```\n\n### 4.3 Get \u002F Delete Webhook — `webhook\u002Fget.json` \u002F `webhook\u002Fdelete.json`\n\n```bash\n# Get\ncurl -X POST \"...\u002Fwebhook\u002Fget.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{\"url\": \"https:\u002F\u002Fyourapp.com\u002Funione-webhook\"}'\n\n# Delete\ncurl -X POST \"...\u002Fwebhook\u002Fdelete.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{\"url\": \"https:\u002F\u002Fyourapp.com\u002Funione-webhook\"}'\n```\n\n---\n\n## 5. Suppression List Management\n\n### 5.1 Add — `suppression\u002Fset.json`\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.unione.io\u002Fen\u002Ftransactional\u002Fapi\u002Fv1\u002Fsuppression\u002Fset.json?platform=openclaw\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -d '{\"email\": \"user@example.com\", \"cause\": \"unsubscribed\", \"created\": \"2026-01-15 12:00:00\"}'\n```\n\nCause values: `\"unsubscribed\"`, `\"temporary_unavailable\"`, `\"permanent_unavailable\"`, `\"complained\"`.\n\n### 5.2 Check — `suppression\u002Fget.json`\n\n```bash\ncurl -X POST \"...\u002Fsuppression\u002Fget.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{\"email\": \"user@example.com\"}'\n```\n\n### 5.3 List — `suppression\u002Flist.json`\n\n```bash\ncurl -X POST \"...\u002Fsuppression\u002Flist.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{\"cause\": \"hard_bounced\", \"limit\": 50, \"offset\": 0}'\n```\n\n### 5.4 Delete — `suppression\u002Fdelete.json`\n\n```bash\ncurl -X POST \"...\u002Fsuppression\u002Fdelete.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{\"email\": \"user@example.com\"}'\n```\n\n---\n\n## 6. Event Dumps\n\n### 6.1 Create — `event-dump\u002Fcreate.json`\n\n```bash\ncurl -X POST \"...\u002Fevent-dump\u002Fcreate.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"start_time\": \"2026-01-01 00:00:00\", \"end_time\": \"2026-01-31 23:59:59\", \"limit\": 50000, \"all_events\": true}'\n```\n\n### 6.2 Get \u002F List \u002F Delete\n\n```bash\n# Get dump status and download URL\ncurl -X POST \"...\u002Fevent-dump\u002Fget.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{\"dump_id\": \"dump-id\"}'\n\n# List all dumps\ncurl -X POST \"...\u002Fevent-dump\u002Flist.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{}'\n\n# Delete a dump\ncurl -X POST \"...\u002Fevent-dump\u002Fdelete.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{\"dump_id\": \"dump-id\"}'\n```\n\n---\n\n## 7. Tags — `tag\u002Flist.json` \u002F `tag\u002Fdelete.json`\n\n```bash\n# List tags\ncurl -X POST \"...\u002Ftag\u002Flist.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{}'\n\n# Delete tag\ncurl -X POST \"...\u002Ftag\u002Fdelete.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{\"tag_id\": 123}'\n```\n\n---\n\n## 8. Projects — `project\u002Fcreate.json` \u002F `project\u002Flist.json`\n\n```bash\n# Create project\ncurl -X POST \"...\u002Fproject\u002Fcreate.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"project\": {\"name\": \"My Project\", \"send_enabled\": true}}'\n\n# List projects\ncurl -X POST \"...\u002Fproject\u002Flist.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{}'\n```\n\n---\n\n## 9. System Info — `system\u002Finfo.json`\n\n```bash\ncurl -X POST \"...\u002Fsystem\u002Finfo.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" -d '{}'\n```\n\n---\n\n## 10. Subscribe (Double Opt-In) — `email\u002Fsubscribe.json`\n\n```bash\ncurl -X POST \"...\u002Femail\u002Fsubscribe.json?platform=openclaw\" -H \"X-API-KEY: $UNIONE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"from_email\": \"newsletter@yourdomain.com\", \"from_name\": \"Newsletter\", \"to_email\": \"newsubscriber@example.com\"}'\n```\n\n---\n\n## Instructions for the Agent\n\n1. **Domain setup is mandatory.** Before the first send, always check if the user's domain is verified. Run `domain\u002Flist.json` to check. If not verified, guide them through the domain setup process (Section: Domain Setup).\n2. **Always use `api.unione.io`** as the API host for all requests.\n3. **Never send an email without explicit user confirmation.** Always show the recipient, subject, and body summary before executing `email\u002Fsend.json`.\n4. **Always include `idempotency_key`** in `email\u002Fsend.json` requests. Generate a UUID for each unique send. Reuse the same key when retrying.\n5. **Implement retry logic** for 429 and 5xx errors with exponential backoff (see Error Handling section). Never retry 400, 401, 403, 404, 413 errors.\n6. **For template operations**, list available templates first before asking which one to use.\n7. **For validation**, report the result clearly and suggest action.\n8. **Handle errors gracefully.** If a request returns an error, explain what went wrong and suggest a fix.\n9. **Remind users** that the `from_email` domain must be verified in their UniOne account.\n10. **Substitution syntax** uses double curly braces: `{{variable_name}}`.\n11. **Attachments** must be base64-encoded. Help the user encode files if needed.\n12. **Security**: Never log or display the full API key. Remind users to keep their API key secret.\n13. **Code language**: When the user's project uses a specific language (Node.js, Python, Go, PHP, etc.), provide code examples in that language. The examples in this skill can be adapted to any language that can make HTTP POST requests with JSON.\n\n## Common Workflows\n\n### \"Send a test email\"\n1. Check domain verification (`domain\u002Flist.json`)\n2. If domain not verified, guide through domain setup\n3. Ask for recipient email address\n4. Compose a simple test message\n5. Confirm with user before sending\n6. Execute `email\u002Fsend.json` with `idempotency_key`\n7. Report the job_id on success\n\n### \"Check my deliverability setup\"\n1. Run `system\u002Finfo.json` to get account status\n2. Run `domain\u002Flist.json` to check domain verification\n3. For each unverified domain, run `domain\u002Fget-dns-records.json` and show required records\n4. Run `domain\u002Fvalidate-dkim.json` to check DKIM\n5. Suggest fixes if domains are not fully verified\n\n### \"Validate a list of emails\"\n1. For each email, call `email-validation\u002Fsingle.json`\n2. Categorize results: valid, invalid, unknown\n3. Report summary\n\n### \"Set up delivery tracking\"\n1. Ask for webhook URL and events to track\n2. Execute `webhook\u002Fset.json`\n3. Confirm setup\n\n## Resources\n\n- Full API Reference: https:\u002F\u002Fdocs.unione.io\u002Fen\u002Fweb-api-ref\n- Getting Started: https:\u002F\u002Fdocs.unione.io\u002Fen\u002F\n- Template Engines: https:\u002F\u002Fdocs.unione.io\u002Fen\u002Fweb-api#section-template-engines\n- Sign Up: https:\u002F\u002Fcp.unione.io\u002Fen\u002Fuser\u002Fregistration\u002F\n",{"name":5,"metadata":24,"description":30},{"openclaw":25},{"emoji":26,"requires":27,"primaryEnv":29},"📧",{"env":28},[29],"UNIONE_API_KEY","Send transactional and marketing emails via UniOne Email API. Manage email templates, validate email addresses, check delivery statistics, manage suppression lists, configure webhooks, and handle domain settings. UniOne delivers billions of emails annually with 99.88% deliverability.\n","master","4aa004da461d820f4ea5499e58eb8d196cf99016","community\u002Fclawhub\u002Fu\u002Funione",0,"https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge","https:\u002F\u002Fskill-explorer-rho.vercel.app","https:\u002F\u002Fgithub.com\u002FLord1Egypt","Unbreakable. Unstoppable. Unmatched⚡.\r\n Speaker of machine tongues 🤖  | World-builder of decentralized dreams 🌐 | Defender of the digital realm🛡️.","2026-06-10 08:21:01",{"source":8,"skillName":5,"commands":41,"prompt":51,"zipAvailable":52},[42,45,48],{"tool":43,"command":44},"npx","npx skills add Lord1Egypt\u002Fawesome-skill-forge --skill unione",{"tool":46,"command":47},"bunx","bunx skills add Lord1Egypt\u002Fawesome-skill-forge --skill unione",{"tool":49,"command":50},"pnpm","pnpm dlx skills add Lord1Egypt\u002Fawesome-skill-forge --skill unione","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fu\u002Funione\u002FSKILL.md",true,[],[55,62,69,76,83,90],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":19},"01M785WKJB99G3STR1NF9NRTJW","youtube-content","YouTube transcripts to summaries, threads, blogs.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fyoutube-content\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M785WEFHB0G2S9YA6EPR3H0E","xurl","X\u002FTwitter via xurl CLI: post, search, DM, media, v2 API.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fxurl\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M785W98EDN4EFJXJPMQEHCRC","touchdesigner-mcp","Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftouchdesigner-mcp\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M785W5S9FP3QBH2V191E025P","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M785W2AS08NSSH9YATCV6FJB","teams-meeting-pipeline","Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fteams-meeting-pipeline\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M785VXKW4T34BTP1SCHW1R7F","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fsystematic-debugging\u002FSKILL.md",[],[]]