AI Agent

Inbound Email: Set Up Your Address

Find your personal ClearSpan agent email address and email or forward work to it.

You have a personal ClearSpan email address that routes straight to your engineer assistant. Send or forward an email to it and the assistant acts on it unattended, then emails you back. This page covers finding your address and the one rule that keeps it secure.

Finding your address#

Open your profile / account settings in ClearSpan. Your personal agent email address is shown there, read-only — you don't create or change it. The address is provisioned automatically the first time you view it.

The address looks like this, with a unique token as the local part:

<your-unique-token>@mail.withclearspan.com
Note

The receiving domain (the part after the @) is configured by your deployment. Use the exact address shown in your account — don't guess it.

Who gets an address#

The agent email is for engineers and firm staff. You'll see an address when:

  • your account belongs to a firm, and
  • your account is not a client account.

If you don't see an address, your account isn't eligible for the email agent.

How to use it#

You can use the address two ways:

  1. Email it directly — write a new message to your agent address describing what you want done, and attach any files.
  2. Forward to it — forward a client email or a thread to your agent address so the assistant can act on its contents.

In both cases, the assistant replies to you by email and the conversation also appears in Chat History.

The one security rule#

Your address contains a secret token, but because that token travels in plaintext email headers (and survives forwarding), ClearSpan does not trust it alone. The inbound email must also come from your own account email address.

Warning

Always send or forward from the email address on your ClearSpan account. If the From: address doesn't match your account, the message is silently ignored — even if the agent address is correct.

This rule is forwarding-friendly: when you forward a client's email, you are the one sending the forward, so the From: is your account and it goes through. The client's original address inside the forwarded content doesn't matter.

What happens next#

Once an email is accepted, the assistant processes it in the background and emails you a reply. For the full flow — including attachments, replies, and current limitations — see Inbound Email: How It Works & Limits.