Event webhook · Pengiriman

failed

Dikirim saat kami menyerah pada sebuah email setelah percobaan ulangnya habis.

i

Dikirim sebagai POST bertanda tangan ke URL webhook Anda. Lihat Penyiapan & event untuk cara memverifikasi tanda tangan.

Payload

// Rate-limit cycles ran out
{
  "event": "failed",
  "emailId": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
  "timestamp": "2026-10-23T04:32:10.000Z",
  "data": {
    "recipientEmail": "user@example.com",
    "fromAddress": "hello@yourdomain.com",
    "reason": "Max retries (4) exceeded: 421 4.7.28 Our system has detected an unusual rate of mail from your IP"
  }
}
!

Anda mungkin juga menerima bounced. Saat error sementara, kegagalan koneksi, atau greylisting kehabisan percobaan ulang, email juga dicatat sebagai bounce dan event bounced dikirim. Saat siklus rate limit habis, hanya failed yang dikirim.

i

Atur berapa lama kami terus mencoba. Atur retryRateLimited, retryUnavailable, dan retryUnavailableSeconds per email.

Opsi pengiriman →

Referensi field

  • event

    Nilai tetap: "failed".

  • emailId

    ID email, sama dengan yang dikembalikan oleh POST /send.

  • timestamp

    Kapan event terjadi (ISO 8601, UTC).

  • data.recipientEmail

    Alamat email penerima.

  • data.fromAddress

    Alamat email pengirim.

  • data.reason

    Alasan kami menyerah. "Max retries (N) exceeded" berarti siklus rate limit habis; selain itu, berisi jawaban terakhir dari server penerima.

  • data.notSent

    Hanya muncul (true) jika email tidak pernah dikirim karena kondisi akun Anda: kredit habis, akun diblokir atau dibatasi, domain pengirim terdaftar di Spamhaus atau tanpa DKIM, atau From tidak valid. Ini bukan bounce. Log berstatus not_sent dan data.reason berisi penyebab pastinya.