REST API リファレンス

Authorization: Bearer zs_your_api_key_here

https://api.zeabur.com/api/v1/zsend

POST /emails

{
  "from": "[email protected]",
  "to": ["[email protected]"],
  "cc": ["[email protected]"],           // オプション
  "bcc": ["[email protected]"],         // オプション
  "reply_to": ["[email protected]"], // オプション
  "subject": "メールの件名",
  "html": "<h1>HTML コンテンツ</h1>",
  "text": "プレーンテキストコンテンツ",
  "attachments": [                    // オプション
    {
      "filename": "document.pdf",
      "content": "base64_encoded_content",
      "content_type": "application/pdf"
    }
  ],
  "headers": {                        // オプション
    "X-Custom-Header": "value"
  },
  "tags": {                           // オプション
    "campaign": "newsletter",
    "user_id": "12345"
  }
}

{
  "id": "696de2c84210d814d66ee052",
  "message_id": "",
  "status": "pending"
}

curl -X POST https://api.zeabur.com/api/v1/zsend/emails \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "from": "[email protected]",
    "to": ["[email protected]"],
    "subject": "Zeabur Email へようこそ",
    "html": "<h1>ようこそ！</h1><p>Zeabur Email をご利用いただきありがとうございます。</p>"
  }'

// JavaScript の例
const fs = require('fs');
 
const fileContent = fs.readFileSync('document.pdf');
const base64Content = fileContent.toString('base64');
 
const response = await fetch('https://api.zeabur.com/api/v1/zsend/emails', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    from: '[email protected]',
    to: ['[email protected]'],
    subject: '添付ファイルテスト',
    html: '<p>添付ファイルをご確認ください</p>',
    attachments: [{
      filename: 'document.pdf',
      content: base64Content,
      content_type: 'application/pdf'
    }]
  })
});

POST /emails/schedule

{
  "from": "[email protected]",
  "to": ["[email protected]"],
  "cc": ["[email protected]"],              // オプション
  "bcc": ["[email protected]"],            // オプション
  "reply_to": ["[email protected]"],  // オプション
  "subject": "スケジュールメール",
  "html": "<h1>HTMLコンテンツ</h1>",
  "text": "プレーンテキストコンテンツ",
  "attachments": [],                     // オプション
  "headers": {},                         // オプション
  "tags": {},                            // オプション
  "scheduled_at": "2026-01-25T10:00:00Z" // 必須、ISO 8601 形式
}

{
  "id": "696de2c84210d814d66ee053",
  "status": "enqueued"
}

GET /emails/scheduled

{
  "scheduled_emails": [
    {
      "id": "696de2c84210d814d66ee053",
      "from": "[email protected]",
      "to": ["[email protected]"],
      "subject": "スケジュールメール",
      "scheduled_at": "2026-01-25T10:00:00Z",
      "status": "enqueued",
      "created_at": "2026-01-20T08:00:00Z",
      "attempts": 0
    }
  ],
  "total_count": 1
}

GET /emails/scheduled/:id

DELETE /emails/scheduled/:id

POST /emails/batch

{
  "emails": [
    {
      "from": "[email protected]",
      "to": ["[email protected]"],
      "cc": ["[email protected]"],       // オプション
      "bcc": ["[email protected]"],      // オプション
      "reply_to": ["[email protected]"], // オプション
      "subject": "パーソナライズメール1",
      "html": "<p>こんにちは、ユーザー1！</p>",
      "text": "こんにちは、ユーザー1！",    // オプション
      "attachments": [],                   // オプション
      "headers": {},                       // オプション
      "tags": {"user_id": "1"}             // オプション
    },
    {
      "from": "[email protected]",
      "to": ["[email protected]"],
      "subject": "パーソナライズメール2",
      "html": "<p>こんにちは、ユーザー2！</p>"
    }
    // ... 最大100通
  ]
}

{
  "job_id": "696de2c84210d814d66ee054",
  "status": "pending",
  "total_count": 2
}

GET /emails

{
  "error": "簡単なエラー説明",
  "message": "詳細なエラーメッセージ"
}

{
  "tags": {
    "campaign": "welcome_series",
    "user_segment": "new_users",
    "template_version": "v2"
  }
}