Skip to main content

Email Forwarding

Forward captured emails to HTTP endpoints. This converts inbound emails into webhook-style HTTP POST requests, making it easy to test email-triggered workflows.

How it works​

When an email arrives at your inbox:

  1. The email is captured and stored as usual
  2. Hooklistener converts the email into an HTTP POST request
  3. The request is sent to your configured target URL
  4. The target's response is recorded

Setting up forwarding​

  1. Navigate to your inbox in the dashboard
  2. Open Forwarding Settings
  3. Enter the target URL (e.g., http://localhost:3000/incoming-email)
  4. Save the configuration

Forwarded request format​

The forwarded HTTP request includes:

{
  "from": "[email protected]",
  "to": "[email protected]",
  "subject": "Email Subject",
  "text_body": "Plain text content",
  "html_body": "<html>...</html>",
  "headers": {
    "message-id": "<[email protected]>",
    "date": "Wed, 15 Jan 2025 10:30:00 +0000"
  },
  "attachments": [
    {
      "filename": "report.pdf",
      "content_type": "application/pdf",
      "size": 12345
    }
  ]
}

Use cases​

  • Test inbound email processing — forward to your local server to test email parsing code
  • Email-to-ticket workflows — test support ticket creation from emails
  • Email-triggered automations — test workflows triggered by incoming emails
  • Staging environments — capture and forward emails in staging without affecting production