Emailit
Docs Webhooks Events

email.accepted

Fired when an email is accepted for delivery.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.accepted",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Welcome to Emailit",
      "meta": { "campaign": "welcome-series" },
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Fields

id string

Unique email identifier.

object string

Always email.

from string

Sender email address.

to string

Recipient email address.

subject string

Email subject line.

meta object | null

Custom metadata attached to the email.

created_at string

ISO 8601 timestamp when the email was created.

email.scheduled

Fired when an email is scheduled for future delivery.

{
  "event_id": "2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.scheduled",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Weekly Digest",
      "meta": { "series": "weekly" },
      "scheduled_at": "2026-02-15T09:00:00.000000+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Fields

id string

Unique email identifier.

object string

Always email.

from string

Sender email address.

to string

Recipient email address.

subject string

Email subject line.

meta object | null

Custom metadata attached to the email.

scheduled_at string

ISO 8601 timestamp for scheduled delivery.

created_at string

ISO 8601 timestamp when the email was created.

email.delivered

Fired when an email is successfully delivered to the recipient’s mail server.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.delivered",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Welcome to Emailit",
      "status": "delivered",
      "meta": { "campaign": "welcome-series" },
      "updated_at": "2026-02-11T22:14:33.481927+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Fields

id string

Unique email identifier.

object string

Always email.

from string

Sender email address.

to string

Recipient email address.

subject string

Email subject line.

status string

Always delivered.

meta object | null

Custom metadata attached to the email.

updated_at string

ISO 8601 timestamp of the status change.

created_at string

ISO 8601 timestamp when the email was created.

email.bounced

Fired when an email permanently fails delivery (hard bounce).

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.bounced",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Welcome to Emailit",
      "status": "bounced",
      "meta": { "campaign": "welcome-series" },
      "updated_at": "2026-02-11T22:14:33.481927+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Fields

id string

Unique email identifier.

object string

Always email.

from string

Sender email address.

to string

Recipient email address.

subject string

Email subject line.

status string

Always bounced.

meta object | null

Custom metadata attached to the email.

updated_at string

ISO 8601 timestamp of the status change.

created_at string

ISO 8601 timestamp when the email was created.

email.attempted

Fired when email delivery is attempted but results in temporary failure.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.attempted",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Welcome to Emailit",
      "status": "attempted",
      "meta": { "campaign": "welcome-series" },
      "updated_at": "2026-02-11T22:14:33.481927+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Fields

id string

Unique email identifier.

object string

Always email.

from string

Sender email address.

to string

Recipient email address.

subject string

Email subject line.

status string

Always attempted.

meta object | null

Custom metadata attached to the email.

updated_at string

ISO 8601 timestamp of the status change.

created_at string

ISO 8601 timestamp when the email was created.

email.failed

Fired when an email fails to be delivered, usually caused by a specific error during delivery.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.failed",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Welcome to Emailit",
      "status": "failed",
      "meta": { "campaign": "welcome-series" },
      "updated_at": "2026-02-11T22:14:33.481927+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Fields

id string

Unique email identifier.

object string

Always email.

from string

Sender email address.

to string

Recipient email address.

subject string

Email subject line.

status string

Always failed.

meta object | null

Custom metadata attached to the email.

updated_at string

ISO 8601 timestamp of the status change.

created_at string

ISO 8601 timestamp when the email was created.

email.rejected

Fired when an email was accepted for delivery but rejected afterwards.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.rejected",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Welcome to Emailit",
      "status": "rejected",
      "meta": { "campaign": "welcome-series" },
      "updated_at": "2026-02-11T22:14:33.481927+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Fields

id string

Unique email identifier.

object string

Always email.

from string

Sender email address.

to string

Recipient email address.

subject string

Email subject line.

status string

Always rejected.

meta object | null

Custom metadata attached to the email.

updated_at string

ISO 8601 timestamp of the status change.

created_at string

ISO 8601 timestamp when the email was created.

email.suppressed

Fired when the email recipient is on the suppression list.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.suppressed",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Welcome to Emailit",
      "status": "suppressed",
      "meta": { "campaign": "welcome-series" },
      "updated_at": "2026-02-11T22:14:33.481927+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Fields

id string

Unique email identifier.

object string

Always email.

from string

Sender email address.

to string

Recipient email address.

subject string

Email subject line.

status string

Always suppressed.

meta object | null

Custom metadata attached to the email.

updated_at string

ISO 8601 timestamp of the status change.

created_at string

ISO 8601 timestamp when the email was created.

email.received

Fired when an incoming email is accepted.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.received",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Welcome to Emailit",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Fields

id string

Unique email identifier.

object string

Always email.

from string

Sender email address.

to string

Recipient email address.

subject string

Email subject line.

created_at string

ISO 8601 timestamp when the email was received.

email.complained

Fired when a complaint is registered for this email (e.g. marked as spam).

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.complained",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Welcome to Emailit",
      "status": "complained",
      "meta": { "campaign": "welcome-series" },
      "updated_at": "2026-02-11T22:14:33.481927+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Fields

id string

Unique email identifier.

object string

Always email.

from string

Sender email address.

to string

Recipient email address.

subject string

Email subject line.

status string

Always complained.

meta object | null

Custom metadata attached to the email.

updated_at string

ISO 8601 timestamp of the status change.

created_at string

ISO 8601 timestamp when the email was created.

email.clicked

Fired when a link within an email is clicked. Includes click details such as IP address, user agent, and the URL that was clicked.

{
  "event_id": "...",
  "type": "email.clicked",
  "data": {
    "object": {
      "id": "click_4yM2nTvR8oPcX3u...",
      "object": "click",
      "email": {
        "id": "em_...",
        "rcpt_to": "recipient@example.com",
        "mail_from": "sender@example.com",
        "subject": "Welcome",
        "created_at": "...",
        "meta": null
      },
      "link": {
        "id": "link_...",
        "url": "https://example.com/page"
      },
      "ip_address": "203.0.113.42",
      "user_agent": "Mozilla/5.0 ...",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Fields

id string

Unique click identifier.

object string

Always click.

email object

The email that was clicked.

email.id string

Email identifier.

email.rcpt_to string

Recipient email address.

email.mail_from string

Sender email address.

email.subject string

Email subject line.

email.meta object | null

Custom metadata attached to the email.

link.id string

Link identifier.

link.url string

The URL that was clicked.

ip_address string

IP address of the click.

user_agent string

User agent string of the client.

created_at string

ISO 8601 timestamp of the click.

email.loaded

Fired when email content is loaded by the recipient. Includes tracking details such as IP address and user agent.

{
  "event_id": "...",
  "type": "email.loaded",
  "data": {
    "object": {
      "id": "load_4yM2nTvR8oPcX3u...",
      "object": "load",
      "email": {
        "id": "em_...",
        "rcpt_to": "recipient@example.com",
        "mail_from": "sender@example.com",
        "subject": "Welcome",
        "created_at": "...",
        "meta": null
      },
      "ip_address": "203.0.113.42",
      "user_agent": "Mozilla/5.0 ...",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Fields

id string

Unique load identifier.

object string

Always load.

email object

The email that was loaded.

email.id string

Email identifier.

email.rcpt_to string

Recipient email address.

email.mail_from string

Sender email address.

email.subject string

Email subject line.

email.meta object | null

Custom metadata attached to the email.

ip_address string

IP address of the load.

user_agent string

User agent string of the client.

created_at string

ISO 8601 timestamp of the load.