Taskpath
← All guides

Troubleshooting common setup issues

Email to my address doesn't arrive at all

Mail routing is DNS, separate from your website. Check, in order:

  • MX records point at your mailbox provider (not your web server). A common mistake is entering a mail host without a trailing dot, so the DNS host appends your domain (e.g. mx.provider.com.yourdomain.com) — add the trailing dot.
  • SPF is a single record. If more than one system sends for your domain (e.g. a mailbox provider plus a transactional sender), merge their include: values into one v=spf1 … ~all record — never publish two.
  • Domain is verified/active at the mailbox provider, not just "pending".
  • No server filter is silently dropping it. Some providers reject or file suspected spam without a bounce, so it can vanish with no error.

Mail arrives but no task is created

  • The assistant mailbox must be linked to the connector (Connections → Assistant mailboxes). If nothing is linked, the connector fetches mail but there's no route to turn it into tasks. The guided Support setup links this for you automatically.
  • If the sender isn't a workspace member, the mailbox must have "Accept email from anyone" turned on; otherwise non-member mail is quarantined.
  • Check the IMAP folder on the connector matches the folder your filter files the mail into.

"Temporary authentication failure" when connecting IMAP

Usually rate-limiting after repeated failed logins — wait a few minutes and retry with the correct password. If your provider blocks IMAP when 2FA is on, use an app-specific password if it offers one for mail, or the main account password.

Drafts/answers aren't generated

An AI provider must be configured (Settings → AI). Without it, classification and knowledge answering can't run. Configure Mistral or an OpenAI-compatible endpoint and re-run.

A trial mailbox can't send replies

Some mailbox providers restrict trial accounts to internal sending only. Activate (pay for) the account before expecting outbound replies to external customers.