Event Types

`email.sent`

Occurs whenever the API request was successful. Resend will attempt to deliver the message to the recipient’s mail server.

Sample Request Body

{
  "type": "email.sent",
  "created_at": "2024-02-22T23:41:12.126Z",
  "data": {
    "created_at": "2024-02-22T23:41:11.894719+00:00",
    "email_id": "56761188-7520-42d8-8898-ff6fc54ce618",
    "from": "Acme <onboarding@resend.dev>",
    "to": ["delivered@resend.dev"],
    "subject": "Sending this example",
    "tags": [
      {
        "name": "category",
        "value": "confirm_email"
      }
    ]
  }
}

`email.delivered`

Occurs whenever Resend successfully delivered the email to the recipient’s mail server.

Sample Request Body

{
  "type": "email.delivered",
  "created_at": "2024-02-22T23:41:12.126Z",
  "data": {
    "created_at": "2024-02-22T23:41:11.894719+00:00",
    "email_id": "56761188-7520-42d8-8898-ff6fc54ce618",
    "from": "Acme <onboarding@resend.dev>",
    "to": ["delivered@resend.dev"],
    "subject": "Sending this example",
    "tags": [
      {
        "name": "category",
        "value": "confirm_email"
      }
    ]
  }
}

`email.delivery_delayed`

Occurs whenever the email couldn’t be delivered due to a temporary issue.

Delivery delays can occur, for example, when the recipient’s inbox is full, or when the receiving email server experiences a transient issue.

Sample Request Body

{
  "type": "email.delivery_delayed",
  "created_at": "2024-02-22T23:41:12.126Z",
  "data": {
    "created_at": "2024-02-22T23:41:11.894719+00:00",
    "email_id": "56761188-7520-42d8-8898-ff6fc54ce618",
    "from": "Acme <onboarding@resend.dev>",
    "to": ["delivered@resend.dev"],
    "subject": "Sending this example",
    "tags": [
      {
        "name": "category",
        "value": "confirm_email"
      }
    ]
  }
}

`email.complained`

Occurs whenever the email was successfully delivered, but the recipient marked it as spam.

Sample Request Body

{
  "type": "email.complained",
  "created_at": "2024-02-22T23:41:12.126Z",
  "data": {
    "created_at": "2024-02-22T23:41:11.894719+00:00",
    "email_id": "56761188-7520-42d8-8898-ff6fc54ce618",
    "from": "Acme <onboarding@resend.dev>",
    "to": ["delivered@resend.dev"],
    "subject": "Sending this example",
    "tags": [
      {
        "name": "category",
        "value": "confirm_email"
      }
    ]
  }
}

`email.bounced`

Occurs whenever the recipient’s mail server permanently rejected the email.

Sample Request Body

{
  "type": "email.bounced",
  "created_at": "2024-11-22T23:41:12.126Z",
  "data": {
    "created_at": "2024-11-22T23:41:11.894719+00:00",
    "email_id": "56761188-7520-42d8-8898-ff6fc54ce618",
    "from": "Acme <onboarding@resend.dev>",
    "to": ["delivered@resend.dev"],
    "subject": "Sending this example",
    "bounce": {
      "message": "The recipient's email address is on the suppression list because it has a recent history of producing hard bounces.",
      "subType": "Suppressed",
      "type": "Permanent"
    },
    "tags": [
      {
        "name": "category",
        "value": "confirm_email"
      }
    ]
  }
}

`email.opened`

Occurs whenever the recipient opened the email.

Sample Request Body

{
  "type": "email.opened",
  "created_at": "2024-02-22T23:41:12.126Z",
  "data": {
    "created_at": "2024-02-22T23:41:11.894719+00:00",
    "email_id": "56761188-7520-42d8-8898-ff6fc54ce618",
    "from": "Acme <onboarding@resend.dev>",
    "to": ["delivered@resend.dev"],
    "subject": "Sending this example",
    "tags": [
      {
        "name": "category",
        "value": "confirm_email"
      }
    ]
  }
}

`email.clicked`

Occurs whenever the recipient clicks on an email link.

Sample Request Body

{
  "type": "email.clicked",
  "created_at": "2024-11-22T23:41:12.126Z",
  "data": {
    "created_at": "2024-11-22T23:41:11.894719+00:00",
    "email_id": "56761188-7520-42d8-8898-ff6fc54ce618",
    "from": "Acme <onboarding@resend.dev>",
    "to": ["delivered@resend.dev"],
    "click": {
      "ipAddress": "122.115.53.11",
      "link": "https://resend.com",
      "timestamp": "2024-11-24T05:00:57.163Z",
      "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.1 Safari/605.1.15"
    },
    "subject": "Sending this example",
    "tags": [
      {
        "name": "category",
        "value": "confirm_email"
      }
    ]
  }
}

`contact.created`

Occurs whenever a contact was successfully created.

Note: When importing multiple contacts using CSV, these events won’t be triggered. Contact support if you have any questions.

Sample Request Body

{
  "type": "contact.created",
  "created_at": "2024-11-17T19:32:22.980Z",
  "data": {
    "id": "e169aa45-1ecf-4183-9955-b1499d5701d3",
    "audience_id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
    "created_at": "2024-11-17T19:32:22.980Z",
    "updated_at": "2024-11-17T19:32:22.980Z",
    "email": "steve.wozniak@gmail.com",
    "first_name": "Steve",
    "last_name": "Wozniak",
    "unsubscribed": false
  }
}

`contact.updated`

Occurs whenever a contact was successfully updated.

Sample Request Body

{
  "type": "contact.updated",
  "created_at": "2024-10-11T23:47:56.678Z",
  "data": {
    "id": "e169aa45-1ecf-4183-9955-b1499d5701d3",
    "audience_id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
    "created_at": "2024-10-10T15:11:94.110Z",
    "updated_at": "2024-10-11T23:47:56.678Z",
    "email": "steve.wozniak@gmail.com",
    "first_name": "Steve",
    "last_name": "Wozniak",
    "unsubscribed": false
  }
}

`contact.deleted`

Occurs whenever a contact was successfully deleted.

Sample Request Body

{
  "type": "contact.deleted",
  "created_at": "2024-11-17T19:32:22.980Z",
  "data": {
    "id": "e169aa45-1ecf-4183-9955-b1499d5701d3",
    "audience_id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
    "created_at": "2024-11-10T15:11:94.110Z",
    "updated_at": "2024-11-17T19:32:22.980Z",
    "email": "steve.wozniak@gmail.com",
    "first_name": "Steve",
    "last_name": "Wozniak",
    "unsubscribed": false
  }
}

`domain.created`

Occurs when a domain was successfully created.

Sample Request Body

{
  "type": "domain.created",
  "created_at": "2024-11-17T19:32:22.980Z",
  "data": {
    "id": "d91cd9bd-1176-453e-8fc1-35364d380206",
    "name": "example.com",
    "status": "not_started",
    "created_at": "2024-04-26T20:21:26.347412+00:00",
    "region": "us-east-1",
    "records": [
      {
        "record": "SPF",
        "name": "send",
        "type": "MX",
        "ttl": "Auto",
        "status": "not_started",
        "value": "feedback-smtp.us-east-1.amazonses.com",
        "priority": 10
      },
      {
        "record": "SPF",
        "name": "send",
        "value": "\"v=spf1 include:amazonses.com ~all\"",
        "type": "TXT",
        "ttl": "Auto",
        "status": "not_started"
      },
      {
        "record": "DKIM",
        "name": "resend._domainkey",
        "value": "p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDsc4Lh8xilsngyKEgN2S84+21gn+x6SEXtjWvPiAAmnmggr5FWG42WnqczpzQ/mNblqHz4CDwUum6LtY6SdoOlDmrhvp5khA3cd661W9FlK3yp7+jVACQElS7d9O6jv8VsBbVg4COess3gyLE5RyxqF1vYsrEXqyM8TBz1n5AGkQIDAQA2",
        "type": "TXT",
        "status": "not_started",
        "ttl": "Auto"
      }
    ]
  }
}

`domain.updated`

Occurs when a domain was successfully updated.

Sample Request Body

{
  "type": "domain.updated",
  "created_at": "2024-11-17T19:32:22.980Z",
  "data": {
    "id": "d91cd9bd-1176-453e-8fc1-35364d380206",
    "name": "example.com",
    "status": "not_started",
    "created_at": "2024-04-26T20:21:26.347412+00:00",
    "region": "us-east-1",
    "records": [
      {
        "record": "SPF",
        "name": "send",
        "type": "MX",
        "ttl": "Auto",
        "status": "not_started",
        "value": "feedback-smtp.us-east-1.amazonses.com",
        "priority": 10
      },
      {
        "record": "SPF",
        "name": "send",
        "value": "\"v=spf1 include:amazonses.com ~all\"",
        "type": "TXT",
        "ttl": "Auto",
        "status": "not_started"
      },
      {
        "record": "DKIM",
        "name": "resend._domainkey",
        "value": "p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDsc4Lh8xilsngyKEgN2S84+21gn+x6SEXtjWvPiAAmnmggr5FWG42WnqczpzQ/mNblqHz4CDwUum6LtY6SdoOlDmrhvp5khA3cd661W9FlK3yp7+jVACQElS7d9O6jv8VsBbVg4COess3gyLE5RyxqF1vYsrEXqyM8TBz1n5AGkQIDAQA2",
        "type": "TXT",
        "status": "not_started",
        "ttl": "Auto"
      }
    ]
  }
}

`domain.deleted`

Occurs when a domain was successfully deleted.

Sample Request Body

{
  "type": "domain.deleted",
  "created_at": "2024-11-17T19:32:22.980Z",
  "data": {
    "id": "d91cd9bd-1176-453e-8fc1-35364d380206",
    "name": "example.com",
    "status": "not_started",
    "created_at": "2024-04-26T20:21:26.347412+00:00",
    "region": "us-east-1",
    "records": [
      {
        "record": "SPF",
        "name": "send",
        "type": "MX",
        "ttl": "Auto",
        "status": "not_started",
        "value": "feedback-smtp.us-east-1.amazonses.com",
        "priority": 10
      },
      {
        "record": "SPF",
        "name": "send",
        "value": "\"v=spf1 include:amazonses.com ~all\"",
        "type": "TXT",
        "ttl": "Auto",
        "status": "not_started"
      },
      {
        "record": "DKIM",
        "name": "resend._domainkey",
        "value": "p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDsc4Lh8xilsngyKEgN2S84+21gn+x6SEXtjWvPiAAmnmggr5FWG42WnqczpzQ/mNblqHz4CDwUum6LtY6SdoOlDmrhvp5khA3cd661W9FlK3yp7+jVACQElS7d9O6jv8VsBbVg4COess3gyLE5RyxqF1vYsrEXqyM8TBz1n5AGkQIDAQA2",
        "type": "TXT",
        "status": "not_started",
        "ttl": "Auto"
      }
    ]
  }
}

Documentation

Quickstart

Learn

Resources

`email.sent`

`email.delivered`

`email.delivery_delayed`

`email.complained`

`email.bounced`

`email.opened`

`email.clicked`

`contact.created`

`contact.updated`

`contact.deleted`

`domain.created`

`domain.updated`

`domain.deleted`

Documentation

Quickstart

Learn

Resources

​email.sent

​email.delivered

​email.delivery_delayed

​email.complained

​email.bounced

​email.opened

​email.clicked

​contact.created

​contact.updated

​contact.deleted

​domain.created

​domain.updated

​domain.deleted

`email.sent`

`email.delivered`

`email.delivery_delayed`

`email.complained`

`email.bounced`

`email.opened`

`email.clicked`

`contact.created`

`contact.updated`

`contact.deleted`

`domain.created`

`domain.updated`

`domain.deleted`