# 送信元メールドメインを追加

`POST /v1/email-sender-domains` · 権限 `email-sender-domains:write` · すべてのプラン

環境のメールの送信元として使用できるドメインを、DKIM で署名して追加します。ドメインは `pending_dns` の状態で作成されます。返された `records` を DNS に公開し、ドメインを[検証](verify.md)してください。

送信元ドメインは `production` 環境でのみ追加でき、環境ごとに最大 10 件です。名前は IDNA 2008 の A ラベルに変換され、末尾のドットは削除されます。

2 つの DKIM CNAME（`akp1`、`akp2`）は、プラットフォームが保持する鍵を指します。そのため、鍵をローテーションしてもお客様側で DNS を変更する必要はありません。Return-Path の CNAME は、バウンスをプラットフォームへ戻します。

## リクエスト

| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
| `domain` | string | はい | 送信元とするドメインまたはサブドメイン（Unicode 可）。253 文字以内。 |
| `Idempotency-Key` | header | いいえ | 同じキーによる同一リクエストの再送時に、同じレスポンスを返します。 |

```json
{
  "domain": "mail.example.com"
}
```

## レスポンス

`201 Created` と、新しい送信元ドメインを返します。`ETag` にはそのバージョンが設定されます。各フィールドは [送信元メールドメインを取得](get.md) で説明しています。

```json
{
  "id": "sdom_01k7r9m3q5t8v2w4x6y8z0a2b4",
  "domain": "mail.example.com",
  "status": "pending_dns",
  "active_selector": "akp1",
  "dkim_status": null,
  "return_path_status": null,
  "dmarc_alignment": null,
  "last_checked_at": null,
  "failing_since": null,
  "degraded_since": null,
  "records": [
    {
      "type": "CNAME",
      "name": "akp1._domainkey.mail.example.com",
      "value": "akp1.sdom_01k7r9m3q5t8v2w4x6y8z0a2b4.dkim.eu.keenauth.app",
      "required": true
    },
    {
      "type": "CNAME",
      "name": "akp2._domainkey.mail.example.com",
      "value": "akp2.sdom_01k7r9m3q5t8v2w4x6y8z0a2b4.dkim.eu.keenauth.app",
      "required": true
    },
    {
      "type": "CNAME",
      "name": "rp.mail.example.com",
      "value": "rp.eu.mail.keenauth.app",
      "required": true
    }
  ],
  "version": 1,
  "created_at": "2026-10-19T09:00:00Z",
  "updated_at": "2026-10-19T09:00:00Z"
}
```

## エラー

| HTTP | code | 発生条件 |
|---|---|---|
| 409 | `conflict` | このドメインはこの環境にすでに追加されています。 |
| 409 | `domain_limit_reached` | この環境にはすでに 10 件の送信元ドメインがあります。 |
| 422 | `validation_failed` | `/domain required`: ドメインがありません。`/domain invalid`: IP アドレス、単一ラベル、パブリックサフィックス（例: `co.uk`）、プラットフォームのドメイン（`keenauth.com`、`keenauth.app` とそのサブドメイン）、または DKIM レコード名が 253 オクテットを超えるほど長い名前です。`/domain production_only`: 環境が `production` ではありません。 |
| 422 | `idempotency_key_reuse` | `Idempotency-Key` が、異なるリクエストで使用されました。 |
| 401 | `unauthenticated` | 認証情報が見つからない、無効、または取り消されています。 |
| 403 | `insufficient_permissions` | 認証情報に必要な権限がありません。 |
| 429 | `rate_limited` | レート制限を超えました。`Retry-After` の期間を待ってから再試行してください。 |
| 503 | `service_unavailable` | 依存先が一時的に利用できません。`Retry-After` の期間を待ってから再試行してください。 |

## 例

```bash
curl -X POST https://api.eu.keenauth.com/v1/email-sender-domains \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 5f1c2e8a-7d3b-4c9e-a1f0-2b6d8e4c7a90" \
  -d '{"domain":"mail.example.com"}'
```

CLI: `keenauth email-sender-domains create --domain mail.example.com`