The Complete
inbound Email Service
for Developers

// 1. Setup your inbound email service
import { createInboundClient } from '@inboundemail/sdk'

const inbound = createInboundClient({
  apiKey: process.env.INBOUND_API_KEY
})

// 2. Configure domain and email addresses
await inbound.domains.create({
  domain: 'yourapp.com',
  dnsRecords: 'auto'  // Auto-generate DNS records
})

await inbound.emails.create({
  email: 'support@yourapp.com', 
  webhookUrl: 'https://api.yourapp.com/webhook'
})

// 3. Handle processed emails in your app
app.post('/webhook', (req, res) => {
  const { email }: InboundWebhookPayload = req.body
  
  // Rich, structured email data
  const parsed = email.parsedData
  
  // Customer info (fully typed)
  const customer = {
    email: parsed.from.address,
    name: parsed.from.name
  }
  
  // Email content & metadata
  const content = {
    subject: parsed.subject,
    text: parsed.textBody,
    html: parsed.htmlBody,
    attachments: parsed.attachments
  }
  
  // Threading & conversation data
  const thread = {
    messageId: parsed.messageId,
    inReplyTo: parsed.inReplyTo,
    references: parsed.references
  }
  
  // Process the email data...
  await processCustomerEmail(customer, content, thread)
  
  res.status(200).json({ success: true })
})