E-posta gönderen alan adı ekle

POST /v1/email-sender-domains · izin email-sender-domains:write · tüm planlar

Ortamınızın e-postalarının gönderilebileceği, DKIM ile imzalanmış bir alan adı ekler. Alan adı pending_dns durumunda başlar; döndürülen records kayıtlarını DNS'inizde yayımlayın ve alan adını doğrulayın.

Gönderen alan adları yalnızca production ortamlarında eklenebilir; ortam başına en fazla 10 tane. Ad, bir IDNA 2008 A-etiketine dönüştürülür ve sondaki nokta kaldırılır.

İki DKIM CNAME kaydı (akp1, akp2), platformun tuttuğu anahtarlara işaret eder; bu nedenle anahtar döndürme işlemi sizin tarafınızda hiçbir DNS değişikliği gerektirmez. Return-path CNAME kaydı, geri dönen iletileri platforma yönlendirir.

İstek

Alan	Tür	Zorunlu	Açıklama
`domain`	string	evet	Gönderim yapılacak alan adı veya alt alan adı (Unicode kabul edilir), en fazla 253 karakter.
`Idempotency-Key`	header	hayır	Aynı anahtarla yapılan tekrarlanan istekte aynı yanıtı yeniden döndürür.

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

Yanıt

201 Created ile yeni gönderen alan adı ve sürümüne eşit ETag döner. Alanlar E-posta gönderen alan adını al sayfasında açıklanmıştır.

{
  "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"
}

Hatalar

HTTP	code	Ne zaman
409	`conflict`	Alan adı bu ortama zaten eklenmiş.
409	`domain_limit_reached`	Ortamın zaten 10 gönderen alan adı var.
422	`validation_failed`	`/domain required`: alan adı yok. `/domain invalid`: bir IP adresi, tek etiket, kamu son eki (örneğin `co.uk`), platform alan adı (`keenauth.com`, `keenauth.app` ve alt alan adları) veya DKIM kayıt adı 253 oktetı aşacak kadar uzun bir ad. `/domain production_only`: ortam `production` değil.
422	`idempotency_key_reuse`	`Idempotency-Key` farklı bir istekle kullanıldı.
401	`unauthenticated`	Kimlik bilgisi eksik, geçersiz veya iptal edilmiş.
403	`insufficient_permissions`	Kimlik bilgisi gerekli izne sahip değil.
429	`rate_limited`	Hız sınırı aşıldı; `Retry-After` süresinden sonra yeniden deneyin.
503	`service_unavailable`	Bir bağımlılık geçici olarak kullanılamıyor; `Retry-After` süresinden sonra yeniden deneyin.

Örnek

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