Skip to content
emailkit
Esc
navigateopen⌘Jpreview
On this page

email.onUnknown

A verified provider event emailkit cannot normalize.

Fires for a webhook that passed verification but doesn’t map to any shared event — a provider-specific or brand-new event type. Rare, but it means nothing gets silently dropped: the original payload is in data.

hooks: {
  email: {
    onUnknown: async (event) => {
      logger.info("unhandled email event", {
        emailDriver: event.emailDriver,
        data: event.data,
      });
    },
  },
},

Payload

PropType
emailDriver?string

EmailKit driver id that produced this event

Typestring
type"unknown"

Always "unknown"

Type"unknown"
dataunknown

The unnormalized provider payload

Typeunknown
raw?unknown

Provider-specific raw data (for debugging or advanced use cases)

Typeunknown

Last updated on July 24, 2026

Was this page helpful?