Give your AI agent its own email inbox

Updated · Markdown

Short answer

Give the agent an address of its own rather than your personal mailbox: it keeps the agent's sign-ups and replies separate and limits what the agent can see. Agentline gives every account an @agentline.nz inbox that's live from day one. The agent reads mail with list_emails and read_email, sends with send_email, and waits for emailed codes with wait_for_code. The Free plan includes 1 inbox and 100 outbound emails a month, sent only to the owner's verified address.

Why not just use your Gmail?

Connecting an agent to your main mailbox gives it everything: banking alerts, private threads, password resets. A separate inbox gives it only what you send its way. It also makes it obvious to recipients that a message came from an assistant.

How the inbox works

  • Every account gets an address like ari@agentline.nz. You can choose the name at signup. Pro includes 5 inboxes.
  • Inbound mail is unlimited and scanned for one-time codes.
  • Outbound mail comes from the agent's own address, up to 5 recipients per message.
  • The original message is available as an .eml for anything that needs headers.

Replying in the same thread

To answer an email, the agent calls send_email with reply_to_id set to the message it's replying to. Agentline adds the In-Reply-To and References headers, so the reply lands in the same conversation in the other person's mail app instead of starting a new one.

Email allowances

PlanInboxesOutbound emails a month
Free1100
Starter1500
Pro52,000

Allowances reset on the 1st of each month (NZ time). If the agent reaches one, sending pauses; nothing is charged as overage.

Free plan and trials

On the Free plan and during a trial, the agent can send only to the account owner's verified email (and verified mobile, if any). That stops a new account being used to spam strangers. Paid plans can email anyone, within the acceptable use rules.

Getting started

Create a free account, then connect your client from the install page.

Common questions

Is the Free plan really free?
Yes. The Free plan is NZ$0 with no card: 1 @agentline.nz inbox, unlimited inbound email and 100 outbound emails a month, sent only to your own verified address. It has no phone number.
Can the agent read codes sent by email?
Yes. Every inbound email is scanned for a one-time code, and wait_for_code returns it (outside ChatGPT, where codes are hidden by default).
Can I pick the inbox address?
Yes. Choose a name of 3 to 30 lowercase letters, numbers, dots or hyphens at signup, or leave it blank for a random one.

Give your agent a number

Inbox live from day one; NZ 028 number set up within a few days of signup.

Get started

Related guides