Missing exports:InboundWebhookPayload, verifyWebhookFromHeaders #28

Activity

1. R44VC0RP commented on Dec 15, 2025

   

   R44VC0RP

   on Dec 15, 2025

   Contributor

   More actions

   Good call, going to get those added in 0.20.0.
2. R44VC0RP

   self-assigned this

   on Dec 15, 2025
3. R44VC0RP

   added a commit that references this issue on Dec 21, 2025

   feat: add webhook payload types and verification helpers

   ...

   31e3c44
4. R44VC0RP commented on Dec 21, 2025

   

   R44VC0RP

   on Dec 21, 2025

   Contributor

   More actions

   Fixed in PR #27 (0.20.0 release). Added the following exports:

   Types:

   • InboundWebhookPayload - Complete webhook payload structure
   • InboundEmail, InboundEmailAddress, InboundEmailAddressField
   • InboundAttachment, InboundParsedEmailData, InboundCleanedContent
   • InboundEndpointInfo

   Functions:

   • isInboundWebhookPayload() - Type guard for payload validation
   • verifyWebhook() - Verify webhook by endpoint ID and token
   • verifyWebhookFromHeaders() - Verify webhook using request headers

   Usage:

   import { Inbound, verifyWebhookFromHeaders, type InboundWebhookPayload } from 'inboundemail'
   
   const inbound = new Inbound(process.env.INBOUND_API_KEY!)
   
   export async function POST(request: Request) {
     const isValid = await verifyWebhookFromHeaders(request.headers, inbound)
     
     if (!isValid) {
       return new Response('Unauthorized', { status: 401 })
     }
     
     const payload: InboundWebhookPayload = await request.json()
     console.log(`Received verified email: ${payload.email.subject}`)
     
     return new Response('OK', { status: 200 })
   }
5. R44VC0RP

   closed this as completedon Dec 21, 2025