MailLandDocs
Alan Adları

Alan Adı Ekleme

Mail.Land çalışma alanınıza gönderim alan adı ekleme ve yapılandırma

MailLand aracılığıyla e-posta göndermeden önce en az bir gönderim alan adı eklemeniz ve doğrulamanız gerekmektedir. Bu işlem, alan adının size ait olduğunu kanıtlar ve MailLand'e sizin adınıza gönderim yapma yetkisi verir.

Alan Adı Ekleme

POST https://api.mail.land/v1/domains
Add a domain
curl -X POST https://api.mail.land/v1/domains \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "yourdomain.com"
  }'

Yanıt

Durum: 201 Created

Domain response
{
  "id": "k3v9x2m8q1w7z4",
  "domain": "yourdomain.com",
  "verificationStatus": "pending",
  "spfStatus": "pending",
  "dkimStatus": "pending",
  "dmarcStatus": "pending",
  "isFullyVerified": false,
  "trackingSubdomain": "track",
  "useCustomTracking": false,
  "bounceSubdomain": "bounce",
  "useCustomBounce": true,
  "inboundEnabled": false,
  "inboundSubdomain": null,
  "mxVerified": false,
  "healthStatus": "unknown",
  "createdAt": "2026-02-17T10:00:00Z",
  "updatedAt": "2026-02-17T10:00:00Z"
}
AlanTürAçıklama
idstringAlan adının genel kimliği
domainstringAlan adı
verificationStatusenumpending, verified veya failed
spfStatus / dkimStatus / dmarcStatusenumHer kayıt için pending, valid veya invalid
isFullyVerifiedbooleanSahiplik doğrulandı VE SPF, DKIM ve DMARC hepsi valid, gönderim için gerekli
trackingSubdomain / bounceSubdomainstringÖzel alan adı açık olsun olmasın, izleme/geri dönüş alt alan adları
useCustomTracking / useCustomBouncebooleanÖzel izleme/geri dönüş alan adının açık olup olmadığı
inboundEnabledbooleanBu alan adı için gelen e-posta alımının açık olup olmadığı
inboundSubdomainstring | nullGelen MX kaydı için alt alan adı; null alan adı kökü demektir
mxVerifiedbooleanGelen MX kaydının doğrulanıp doğrulanmadığı
healthStatusenumunknown, healthy, warning veya critical
createdAtdatetimeAlan adının eklendiği zaman

Doğrulama jetonu yoktur: bir alan adı eklemek kaydı oluşturur ve DKIM anahtarını otomatik olarak üretir (jeton adımı yok).

Alan adını ekledikten sonra e-posta gönderebilmek için DNS kayıtlarını yapılandırmanız ve sahipliği doğrulamanız gerekmektedir. Gerekli kayıtlar için DNS Kurulumu sayfasına bakınız.

Kurulum Akışı

Alan adını ekleyin

Alan adınızla birlikte POST /v1/domains isteği gönderin. MailLand alan adı kaydını oluşturur ve DKIM anahtarını üretir.

DNS talimatlarını alın

Oluşturmanız gereken tam DNS kayıtlarını almak için GET /v1/domains/{id}/dns-instructions isteği gönderin. DNS Kurulumu sayfasına bakınız.

DNS kayıtlarını yapılandırın

SPF, DKIM ve DMARC kayıtlarını (etkinse isteğe bağlı geri dönüş/izleme CNAME'leriyle birlikte) DNS sağlayıcınıza ekleyin.

Alan adını doğrulayın

Doğrulamayı tetiklemek için POST /v1/domains/{id}/verify isteği gönderin. MailLand tüm DNS kayıtlarını kontrol ederek alan adı durumunu günceller. Doğrulama sayfasına bakınız.

Alan Adlarını Listeleme

GET https://api.mail.land/v1/domains
List domains
curl https://api.mail.land/v1/domains \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
List response
{
  "items": [
    {
      "id": "k3v9x2m8q1w7z4",
      "domain": "yourdomain.com",
      "verificationStatus": "verified",
      "spfStatus": "valid",
      "dkimStatus": "valid",
      "dmarcStatus": "valid",
      "isFullyVerified": true,
      "trackingSubdomain": "track",
      "useCustomTracking": false,
      "bounceSubdomain": "bounce",
      "useCustomBounce": false,
      "inboundEnabled": false,
      "inboundSubdomain": null,
      "mxVerified": false,
      "healthStatus": "healthy",
      "createdAt": "2026-02-17T10:00:00Z",
      "updatedAt": "2026-02-17T10:15:00Z"
    }
  ],
  "nextCursor": "eyJ2IjoxLCJzIjoiY3JlYXRlZGF0OmRlc2MiLCJrIjoi...",
  "hasMore": true
}

Alan Adını Getirme

GET https://api.mail.land/v1/domains/{id}

Doğrulama durumu ve tüm alt alan adları dahil olmak üzere alan adının tam ayrıntılarını döndürür.

Get a domain
curl https://api.mail.land/v1/domains/k3v9x2m8q1w7z4 \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Alan Adı Ayarlarını Güncelleme

Takip ve geri dönme alt alan adlarını özelleştirin ve gelenleri açıp kapatın. Diğer ayar alanları: useCustomTracking, useCustomBounce, inboundEnabled, inboundSubdomain. Bu etiketler yalnızca ilgili özel bayrak açıldığında ve kayıt doğrulandığında etkili olur. useCustomBounce'ı açmak, geri dönüş kaydının doğrulamasını temizler; bu yüzden CNAME'ini yeniden doğrulamanız gerekir:

PATCH https://api.mail.land/v1/domains/{id}/settings
Update domain settings
curl -X PATCH https://api.mail.land/v1/domains/k3v9x2m8q1w7z4/settings \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "trackingSubdomain": "links",
    "bounceSubdomain": "returns"
  }'

Alt alan adlarının değiştirilmesi, DNS kayıtlarınızı güncellemenizi ve alan adını yeniden doğrulamanızı gerektirir.

Alan Adını Silme

DELETE https://api.mail.land/v1/domains/{id}

Başarılı olduğunda 204 No Content döndürür. Bir alan adının silinmesi:

  • Alan adıyla ilişkili tüm DKIM anahtarlarını iptal eder
  • Bu alan adından tüm e-posta gönderimlerini durdurur
  • Takip ve geri dönme yönlendirmesini kaldırır
Delete a domain
curl -X DELETE https://api.mail.land/v1/domains/k3v9x2m8q1w7z4 \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Silme işlemi kalıcıdır. Bu alan adına kapsanlı herhangi bir API kimlik bilgisi artık e-posta gönderemeyecektir. Bu alan adını kullanan aktif kampanyalar veya otomasyonlar başarısız olacaktır.

Hata Yanıtları

DurumKodAçıklama
400VALIDATION_FAILEDGeçersiz alan adı formatı
400INVALID_REQUESTAlan adı zaten eklenmiş (bu çalışma alanına veya başka birine)
400DOMAIN_SUBDOMAIN_EMPTYAyar PATCH'i: bir alt alan adı alanı boş gönderildi
400DOMAIN_SUBDOMAIN_CONFLICTAyar PATCH'i: istenen alt alan adı bu alan adının başka bir kaydı tarafından zaten kullanılıyor
404DOMAIN_NOT_FOUNDAlan adı ID'si mevcut değil
403PLAN_LIMIT_REACHEDPlanınız için maksimum alan adı sayısına ulaşıldı

MailLand gönderim alan adı sayısını plana göre sınırlar ve sınır plandan plana değişir (bazı planlar sınırsızdır). Sınıra ulaşıldığında alan adı eklemek 403 PLAN_LIMIT_REACHED döndürür. Mevcut planınızı Faturalama bölümünde görebilirsiniz.

Sonraki Adımlar

Zamanlanmış E-postalar

Saat dilimi desteği ile gelecekte teslim edilecek e-postaları zamanlayın

DNS Yapılandırması

Gönderim alan adınız için SPF, DKIM ve DMARC kayıtlarını yapılandırın

Bu sayfada

Alan Adı EklemeYanıtKurulum AkışıAlan adını ekleyinDNS talimatlarını alınDNS kayıtlarını yapılandırınAlan adını doğrulayınAlan Adlarını ListelemeAlan Adını GetirmeAlan Adı Ayarlarını GüncellemeAlan Adını SilmeHata YanıtlarıSonraki Adımlar