Let your AI agent sign up to services with its own inbox

Short answer

Your AI agent can sign up to websites and services with its own @agentline.nz email address, which works from day one, and with its Agentline NZ New Zealand 028 number once the number is set up. When the service sends a verification code, the agent calls wait_for_code to collect it, so the agent's accounts, mail and codes stay out of your personal inbox and phone.

Before you start

An Agentline NZ account. Start free with an email inbox (no card), or take a 7-day trial of Starter or Pro to get a number. Your 028 number is set up within a few days of signup. Your email inbox works straight away.
An agent connected over MCP or the REST API. The ChatGPT app doesn't include wait_for_code and hides one-time codes, so use another client, such as Claude, Claude Code or Cursor, for this workflow.
A service whose terms allow an automated agent to hold an account.

Steps

Get the agent's details. The agent calls get_my_number. It returns the agent's @agentline.nz address and, once it's live, its 028 number in +64 28 format.
Fill in the sign-up form. The agent enters its own address, or its number if the service verifies by SMS. While the number is being set up, use the email address.
Call wait_for_code straight away. Right after submitting the form, the agent calls wait_for_code with channel set to email or sms, and from_contains set to part of the sender, such as the service's name. wait_for_code waits up to 55 seconds for a one-time code to arrive by SMS or email, then returns it. If it returns found=false, the agent calls it again.
```
curl -X POST https://agentline.nz/api/v1/wait-for-code \
  -H "Authorization: Bearer $AGENTLINE_KEY" -H "Content-Type: application/json" \
  -d '{"channel":"email","from_contains":"github","timeout_seconds":45}'
```
Enter the code. wait_for_code returns the code, the channel, the sender and when it arrived. The agent types the code into the form to finish signing up. Each code is handed out once.
Handle a link instead of a code. Some services send a confirmation link rather than a code, and wait_for_code only returns codes. The agent calls list_emails with unread_only set to true, opens the message with read_email and follows the link if it can browse, or passes it to you.
Mark the mail read. The agent calls mark_read with the email ids it has dealt with, so the next check with unread_only only shows new mail.

Email or SMS?

	Email	SMS
Works from	Day one	Once the 028 number is live, on Starter or Pro
Address	name@agentline.nz	+64 28 …
wait_for_code channel	email	sms

Use email where the service offers a choice. It works while the number is being set up, and it doesn't depend on the mobile carrier.

Limits to know about

We can't guarantee that every third-party service will accept an Agentline NZ number for verification.
Inbound SMS delivery isn't guaranteed by the carrier, so treat SMS codes as best-effort.
wait_for_code looks at messages from the last 10 minutes unless the agent sets since_seconds, and it covers every inbox and number on the account. If two sign-ups run at once, set from_contains so each one gets its own code.
Use the agent's details for accounts the agent runs itself. Don't make them the recovery email or number for your bank, IRD or other accounts you can't afford to lose. See Can an AI agent receive SMS verification codes in New Zealand?.

Writing back to the service

The agent can reply from its address with send_email, passing reply_to_id to keep the thread. Until you're on a paid plan, your agent can only email or text your own verified email address and mobile number.

FAQ

Can I choose the agent's email address?

Yes. When you sign up on agentline.nz you can choose the name before @agentline.nz: 3 to 30 lowercase letters, numbers, dots or hyphens. A few names, such as support and admin, are reserved.

No. Many services verify by email, and the inbox works from day one. SMS codes need a plan with a number.

What does Agentline NZ cost?

Starter is NZ$29/month and Pro is NZ$79/month, billed in NZ dollars. Start free with an email inbox (no card), or take a 7-day trial of Starter or Pro to get a number. Agentline NZ is not GST-registered, so no GST is charged.

How long does it take to get the 028 number?

Your 028 number is set up within a few days of signup. Your email inbox works straight away. Full refund if your number hasn't arrived within 30 days of your first payment.

Can my assistant send marketing or bulk texts?

No. Transactional and assistant messages only: replies, bookings, confirmations, reminders people asked for, and codes. Marketing, promotions, cold texts and bulk texts are blocked. See What we don't allow.

Start free · Start free with an email inbox (no card), or take a 7-day trial of Starter or Pro to get a number.