Mailhooks
Learn how a minted email address can trigger a workflow when mail arrives.
A Mailhook is an email address Cheqq mints for you — mail sent to it can trigger a workflow, and a workflow can send or reply through it.
Minting an address
Each address looks like support-a1b2c@agent.cheqq.ai: a slug you choose (up to 32 characters) plus a short random suffix to keep it unique. Addresses are scoped to your account, not to a single workflow — once created, any workflow you own can use it in an Email trigger. Manage them from Settings → Mailhooks, or create one inline while configuring an Email trigger.
What happens when mail arrives
Inbound mail is parsed for sender, subject, body text/HTML, and threading headers. Attachment metadata (filename, type) is captured, but attachment contents are not currently carried through to the trigger. Mail to an address that doesn't match any Mailhook is silently ignored rather than bounced.
Filtering what fires
An Email trigger can narrow which mail actually starts a run:
- Only from / Never from — comma-separated sender allow/block lists
- Subject contains — comma-separated substrings
- Observe follow-ups — also fires on replies within the same thread, not just the original message
Sending and replying
A workflow isn't limited to reacting to mail — a Send Email step can send new mail or reply from one of your Mailhook addresses, including threading a reply against the message that triggered the run.
Continue with Set up a Mailhook.