What is Conduit?

Conduit is a hosted service that connects inbound email to HTTP webhooks. When an email arrives at your Conduit address, Conduit delivers it immediately as an HTTP POST to the URL that you configure. There is no polling, and there are no mail servers for you to manage.


Getting started

Getting Started is the place to begin. It covers how to create an account, how to set up your first webhook, and how to send a test email.


Webhooks

Managing Webhooks

Edit a webhook, activate or deactivate it, rotate its secret, or delete it from the web UI.

Webhook Payload Reference

The JSON structure that Conduit delivers to your endpoint, how to verify the signature, payload templates, and custom request headers.

Testing Webhooks

Test your endpoint without real mail through the Simulate action. Or send a real test email through the SMTP gateway with swaks.

Delivery Logs

Read every delivery attempt for a webhook, with the status, the duration and any error. Also explains how the HTTP status maps to the SMTP response.

Example: Slack Notifications

A practical walkthrough that forwards inbound emails to a Slack channel with a payload template.

Example: GitHub or Linear Issues

Forward emails into a GitHub repository or a Linear team as new tickets. Shows how to use custom_headers to authenticate against a third-party API.


Domains and inbound security

Custom Domain

Verify a domain that you own. You can then use your own email addresses, for example alerts@mail.example.com, instead of the shared Conduit domain. Covers the DNS MX record that routes mail to Conduit, and the TXT verification record.

SMTP Security Policy

Restrict who can send email to your webhooks. Allowlist source IP addresses, require SMTP AUTH, enforce SPF and DKIM verification, and limit the sender domains that Conduit accepts.

SMTP Response Headers

Return your own SMTP response codes and messages from your endpoint, with the X-Conduit-SMTP-Code and X-Conduit-SMTP-Message response headers.


Account and access

Account Settings

Change your password, set a display timezone, sign out, or delete your account.

Two-factor Authentication

Enable, manage, or disable 2FA. Includes backup codes and recovery.

API Tokens

Long-lived bearer tokens for CI/CD, scripts, and server-to-server integrations. This page covers the UI. For the full endpoint reference, see Using the API.

Audit Log

A chronological record of every security change and settings change on your account. Available in the web UI and through the REST API. Conduit keeps entries for 180 days.

Using the API

Full reference for every REST API endpoint: authentication, webhooks, delivery logs, security policies, and domains.