MailLandDocs
Pazarlama

Listeler

Hedefli kampanyalar için aboneleri posta listelerine düzenleyin

Posta listeleri, hedefli kampanyalar için aboneleri gruplar halinde düzenlemenizi sağlar. Her abone kaydı bir listeye aittir, ancak aynı e-posta adresinin birden fazla listede ayrı kayıtları olabilir ve kampanyalar belirli bir listeyi veya liste içindeki bir segmenti hedefleyebilir.

Liste Oluşturma

POST https://api.mail.land/v1/marketing/lists
Create list request
{
  "name": "Product Updates",
  "description": "Subscribers interested in product announcements"
}
AlanTürZorunluAçıklama
namestringEvetListe adı (çalışma alanı başına benzersiz olmalıdır)
descriptionstringHayırListe açıklaması
Create a mailing list
curl -X POST https://api.mail.land/v1/marketing/lists \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{ "name": "Product Updates", "description": "Product announcements" }'

Yanıt

List response
{
  "id": "vtmlew96u277jq",
  "name": "Product Updates",
  "description": "Product announcements",
  "isActive": true,
  "subscriberCount": 0,
  "createdAt": "2026-02-17T12:00:00Z",
  "updatedAt": "2026-02-17T12:00:00Z"
}

Tüm Posta Listelerini Listeleme

GET https://api.mail.land/v1/marketing/lists
ParametreTürVarsayılanAçıklama
cursorstring-Önceki sayfanın nextCursor değerinden alınan opak imleç. İlk sayfa için belirtmeyin.
limitint20Sayfa başına öğe sayısı
searchstring-Ada göre arama
isActivebool-Aktif duruma göre filtrele
sortBystring-Sıralama alanı
sortDescboolfalseAzalan sıralama
List all mailing lists
curl "https://api.mail.land/v1/marketing/lists?limit=20" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
List response
{
  "items": [
    {
      "id": "vtmlew96u277jq",
      "name": "Product Updates",
      "description": "Product announcements",
      "isActive": true,
      "subscriberCount": 2500,
      "createdAt": "2026-01-10T08:00:00Z",
      "updatedAt": "2026-02-17T12:00:00Z"
    }
  ],
  "nextCursor": "eyJ2IjoxLCJzIjoiY3JlYXRlZGF0OmRlc2MiLCJrIjoi...",
  "hasMore": true
}

Liste Ayrıntılarını Alma

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

Abone dağılımı dahil genişletilmiş ayrıntıları döndürür:

Get list details
curl https://api.mail.land/v1/marketing/lists/vtmlew96u277jq \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
List detail response
{
  "id": "vtmlew96u277jq",
  "name": "Product Updates",
  "description": "Product announcements",
  "isActive": true,
  "subscriberCount": 2500,
  "activeSubscribers": 2300,
  "unsubscribedCount": 150,
  "bouncedCount": 50,
  "createdAt": "2026-01-10T08:00:00Z",
  "updatedAt": "2026-02-17T12:00:00Z"
}

Liste Güncelleme

PUT https://api.mail.land/v1/marketing/lists/{id}
Update list request
{
  "name": "Product Announcements",
  "description": "Updated description",
  "isActive": true
}
AlanTürZorunluAçıklama
namestringEvetListe adı (benzersiz olmalıdır)
descriptionstringHayırListe açıklaması
isActiveboolHayırAktif durum (varsayılan: true)

isActive yalnızca bir etikettir: false olarak ayarlanması gönderimi engellemez. Kampanya veya worker kodundaki hiçbir şey, bir kampanyanın bu listeyi hedeflemesini engellemek için bu alanı okumaz.

Update a mailing list
curl -X PUT https://api.mail.land/v1/marketing/lists/vtmlew96u277jq \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Product Announcements",
    "description": "Updated description",
    "isActive": true
  }'

Liste Silme

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

Posta listesini siler. Bu listedeki aboneler silinmez ancak mailingListId alanları temizlenir (bir SetNull yabancı anahtarı). Bir liste silindiğinde listeye özel vazgeçmeler korunur.

Bu listedeki bir abonenin zaten listesiz bir kişi kaydı varsa (örneğin daha önce silinen başka bir listede olduğu için), o kişi kaydı korunur ve bu listedeki üyeliği yalnızca geçmiş olarak saklanır: artık kişiler arasında görünmez ve hiçbir kampanya ya da otomasyon onu hedeflemez. Abonelikten çıkma kayıtları, onay kayıtları ve kampanya geçmişi korunur.

Delete a mailing list
curl -X DELETE https://api.mail.land/v1/marketing/lists/vtmlew96u277jq \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Hata Yanıtları

DurumKodAçıklama
400VALIDATION_FAILEDAd zorunludur
400INVALID_REQUESTBu adda bir posta listesi zaten mevcut
403FORBIDDENYetersiz izinler
404RESOURCE_NOT_FOUNDPosta listesi bulunamadı

Sonraki Adımlar

Aboneler

Abone kişilerinizi yönetin, listeleri içe aktarın ve etkileşimleri takip edin

Segmentler

Abone özelliklerine ve davranışlarına dayalı dinamik segmentler oluşturun

Bu sayfada

Liste OluşturmaYanıtTüm Posta Listelerini ListelemeListe Ayrıntılarını AlmaListe GüncellemeListe SilmeHata YanıtlarıSonraki Adımlar